home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d18 / pased14.arc / PAS-ED.MAN < prev    next >
Text File  |  1991-04-28  |  112KB  |  2,960 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                             Pas-Ed (TM) version 1.4
  13.                         Programmer's Editor for Pascal
  14.  
  15.  
  16.                                ┌───────────────┐
  17.                                │ USER'S MANUAL │
  18.                                └───────────────┘
  19.  
  20.  
  21.                        Copyright (C) 1989 by Hedco, Inc.
  22.                              All rights reserved.
  23.  
  24.                                 November, 1989
  25.  
  26.  
  27.                            ────────────────────────
  28.  
  29.  
  30.                                   Hedco, Inc.
  31.                                  P.O. Box 606
  32.                            Tehachapi, CA 93581   USA
  33.  
  34.                            Telephone: (805) 821-0167
  35.                 Monday through Friday, 9am to 5pm Pacific time
  36.  
  37.                            On CompuServe: 76137,1656
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Title Page                                                         Pas-Ed Manual
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                            Copyrights and Trademarks
  66.                            ─────────────────────────
  67.  
  68.  
  69. Pas-Ed version 1.4 is copyrighted (C) 1989 by Hedco, Inc.
  70.  
  71. Pas-Ed and Hedco are trademarks of Hedco, Inc.
  72.  
  73. Turbo Pascal, Turbo Debugger, Turbo Assembler, and Sidekick are registered
  74. trademarks of Borland International, Inc.
  75.  
  76. TurboPower Software is a trademark of TurboPower Software, Inc.
  77.  
  78. WordStar is a registered trademark of WordStar International, Inc.
  79.  
  80. IBM is a registered trademark of International Business Machines Corporation.
  81.  
  82.  
  83.  
  84.  
  85.  
  86. Acknowledgments
  87. ───────────────
  88.  
  89. The EMS/Disk swapping routine is based on the public domain unit EXECSWAP, and
  90. the prompt in the DOS shell is based on the public domain unit TPENV, both
  91. written by Kim Kokkonen, president of TurboPower Software.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. Preface                                                  Pas-Ed Manual - Page i
  117.  
  118.  
  119.  
  120.                            Pas-Ed License Agreement
  121.                            ────────────────────────
  122.  
  123.  
  124. DEFINITIONS
  125. ───────────
  126.  
  127. Hedco - Hedco, Inc.
  128. Pas-Ed - The Pas-Ed software and documentation.
  129.  
  130.  
  131. LICENSE
  132. ───────
  133.  
  134. Pas-Ed is a copyrighted, proprietary program of Hedco.  A single-user limited
  135. license is granted to you to use Pas-Ed for your personal use for a fifteen (15)
  136. day trial period.  If you would like to purchase a single-user license to
  137. continue to use Pas-Ed after the trial period, you may do so by making a $25
  138. payment to Hedco at the address shown on the Title Page of this manual.  To
  139. purchase a group license, contact Hedco for fees and instructions.  If you do
  140. not purchase a license from Hedco to use Pas-Ed, you must discontinue use of
  141. Pas-Ed after the 15 day trial period.
  142.  
  143.  
  144. LIMITED, EXCLUSIVE WARRANTY
  145. ───────────────────────────
  146.  
  147. Hedco warrants that the software will perform substantially as described in the
  148. documentation for a period of 30 days from the date of purchase.  Hedco makes no
  149. other warranty or representation, either express or implied, with respect to the
  150. software or its documentation, their quality, performance, merchantability, or
  151. fitness for a particular purpose.  This Limited Warranty is void if the software
  152. or documentation has been abused, misapplied, or altered.
  153.  
  154.  
  155. LIABILITY DISCLAIMER AND REMEDIES
  156. ─────────────────────────────────
  157.  
  158. In no event will Hedco be liable for direct, indirect, special, incidental or
  159. consequential damages arising out of the use or inability to use Pas-Ed even if
  160. Hedco has been advised of the possibility of such damages, and the entire and
  161. exclusive liability and remedy shall be to return Pas-Ed to Hedco within the
  162. warranty period for replacement or refund.
  163.  
  164.  
  165. GOVERNING LAW
  166. ─────────────
  167.  
  168. This License Agreement shall be governed by the laws of the State of California,
  169. and any action filed hereunder shall only be brought in Kern County, California.
  170.  
  171.  
  172.  
  173.  
  174. Preface                                                  Pas-Ed Manual - Page ii
  175.  
  176.  
  177.  
  178.  
  179.                                Table of Contents
  180.                                ─────────────────
  181.  
  182.  
  183.          Preface                                               Page  i
  184.          Copyrights and Trademarks ............................      i
  185.          Acknowledgments ......................................      i
  186.          Pas-Ed License Agreement .............................     ii
  187.  
  188.  
  189.          Chapter 1   Introduction To Pas-Ed                    Page  1
  190.          About This Manual ....................................      1
  191.          About Pas-Ed .........................................      1
  192.          System Requirements ..................................      3
  193.          Before Running Pas-Ed ................................      4
  194.          Contacting Hedco .....................................      4
  195.  
  196.  
  197.          Chapter 2   What's New In Version 1.4                 Page  5
  198.          New Features .........................................      5
  199.  
  200.  
  201.          Chapter 3   Setting Up Pas-Ed                         Page  9
  202.          Pas-Ed Files .........................................      9
  203.          Getting Pas-Ed Ready .................................      9
  204.          Starting Pas-Ed ......................................     10
  205.          The Status Line ......................................     11
  206.          Navigating The Menu System ...........................     11
  207.          The Options Menu .....................................     12
  208.          The Color Chart ......................................     14
  209.          The User Utilities ...................................     15
  210.          Setting Up The Macros ................................     16
  211.          Setting Up The Files .................................     16
  212.          Setting Up Turbo Pascal ..............................     17
  213.          Ready To Go ..........................................     17
  214.  
  215.  
  216.          Chapter 4   A Tour Of Pas-Ed                          Page 18
  217.          Getting Ready ........................................     18
  218.          Restoring Your Setup .................................     18
  219.          The Editor ...........................................     18
  220.          Switching Exec Files and Directories .................     20
  221.          The Window Menu ......................................     21
  222.          The Search Menu ......................................     21
  223.          The Macro Menu .......................................     22
  224.          The Other Menus ......................................     23
  225.          The Pop-up Tables ....................................     23
  226.          Switching Video Modes ................................     23
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Table of Contents                                                  Pas-Ed Manual
  233.  
  234.  
  235.  
  236.  
  237.                          Table of Contents (continued)
  238.                          ─────────────────────────────
  239.  
  240.  
  241.          Chapter 5   The Pas-Ed Menu System                    Page 24
  242.          About The Menus ......................................     24
  243.          The Menu Selections ..................................     24
  244.          File Menu ............................................     24
  245.          Window Menu ..........................................     26
  246.          Edit Menu ............................................     27
  247.          Search Menu ..........................................     27
  248.          Macros Menu ..........................................     28
  249.          Compile Menu .........................................     29
  250.          Run Menu .............................................     30
  251.          Debug Menu ...........................................     30
  252.          Language Menu ........................................     31
  253.          Options Menu .........................................     35
  254.  
  255.  
  256.          Chapter 6   The Pas-Ed Editor                         Page 40
  257.          About The Editor .....................................     40
  258.          The Editor Message Line ..............................     40
  259.          The Editor Status Line ...............................     41
  260.          The Function Keys ....................................     41
  261.          Entering Text ........................................     43
  262.  
  263.  
  264.          Chapter 7   Hints On Using Pas-Ed                     Page 44
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. Table of Contents                                                  Pas-Ed Manual
  291.  
  292.  
  293.  
  294.  
  295.                       Chapter 1 - Introduction To Pas-Ed
  296.                       ──────────────────────────────────
  297.  
  298.  
  299.  
  300. About This Manual
  301. ─────────────────
  302.  
  303. This manual is organized into seven chapters:
  304.  
  305.      Chapter 1 - Introduction To Pas-Ed (this chapter)
  306.      Chapter 2 - What's New In Version 1.4
  307.      Chapter 3 - Setting Up Pas-Ed
  308.      Chapter 4 - A Tour of Pas-Ed
  309.      Chapter 5 - The Pas-Ed Menu System
  310.      Chapter 6 - The Pas-Ed Editor
  311.      Chapter 7 - Hints on Using Pas-Ed
  312.  
  313. It's assumed in this manual that you're familiar with Turbo Pascal and the Turbo
  314. Integrated Development Environment (IDE).  The Pas-Ed editor is identical to the
  315. editor in the Turbo IDE.  This manual doesn't attempt to explain the intricacies
  316. of Turbo Pascal or of WordStar-type editors.  These subjects are covered in
  317. detail in the Turbo Pascal manuals, which you're assumed to have.
  318.  
  319. This manual strives to get you, the programmer, up and running with Pas-Ed in as
  320. little time as possible.  This is accomplished via a hands-on, setup tutorial in
  321. Chapter 3 - Setting Up Pas-Ed.  Completing this tutorial should take about 15-20
  322. minutes, by which time you should have Pas-Ed set up to your liking.  Those who
  323. are already familiar with Pas-Ed should read Chapter 2 - What's New In Version
  324. 1.4, which explains the new features added to version 1.4.
  325.  
  326. Users familiar with the Turbo IDE or Sidekick should have no trouble running
  327. Pas-Ed at that point.  Those who would like a more complete introduction are
  328. encouraged to read Chapter 4 - A Tour of Pas-Ed, which steps you through some of
  329. the more important features of Pas-Ed as they're explained.
  330.  
  331. With all the new features added to version 1.4, even experienced Pas-Ed users
  332. should read Chapter 3 - Setting Up Pas-Ed and Chapter 4 - A Tour of Pas-Ed.
  333.  
  334. We also recommend browsing through Chapter 7 - Hints on Using Pas-Ed.
  335.  
  336.  
  337.  
  338. About Pas-Ed
  339. ────────────
  340.  
  341. Pas-Ed is an ASCII file programmer's editor created to streamline the process of
  342. editing, compiling, debugging, and running programs written in Turbo Pascal.
  343. Since it's an ASCII file editor, Pas-Ed can also be used to edit programs for
  344.  
  345.  
  346.  
  347.  
  348. Chapter 1 - Introduction To Pas-Ed                       Pas-Ed Manual - Page 1
  349.  
  350.  
  351.  
  352.  
  353. other compilers, but it will be clear when you run Pas-Ed that it's main forte
  354. is Turbo Pascal.  Pas-Ed's support for Turbo Pascal is unmatched by any other
  355. programmer's editor.  Pas-Ed combines the ease of use of the Turbo IDE with
  356. sophisticated multi-file and memory handling abilities to allow you to write
  357. programs far larger than with the Turbo IDE.  Some of Pas-Ed's features include:
  358.  
  359.      - An integrated development environment for ease of use.
  360.  
  361.      - Edit up to 21 files in a combination of DOS and EMS memory.
  362.  
  363.      - Windows can be individually opened and closed, zoomed and unzoomed,
  364.        hidden and unhidden, and recolored.
  365.  
  366.      - Easy movement between the windows using both "hot key" commands and the
  367.        Memory-Files and Recent-Files Pick lists.
  368.  
  369.      - Five user-selected utilities, each with its own command line, can be
  370.        built into and run from the menus.
  371.  
  372.      - 43/50 line screen modes on EGA/VGA systems with a "hot key" video mode
  373.        selector.
  374.  
  375.      - Switch between 25 and 28 lines as the standard screen height (providing
  376.        your video system is in 28 line mode).
  377.  
  378.      - Direct menu support for all Turbo Pascal compiler and linker switches.
  379.  
  380.      - Automatic TPC.CFG compiler configuration file generation based on menu
  381.        selections.
  382.  
  383.      - EMS or disk swapping during DOS shells and compile, debug and run
  384.        sessions, which reduces Pas-Ed's DOS memory usage to only 6K.
  385.  
  386.      - Set up a project file which can easily be "hot keyed" as the program to
  387.        compile, run, or debug.
  388.  
  389.      - When entering file names, the file path can be "hot keyed" between the
  390.        current directory, the Pas-Ed directory, and the EXE/TPU directory.
  391.  
  392.      - Pass a command line to programs being run.
  393.  
  394.      - Menu-operated debugging from within Pas-Ed using Turbo Debugger, and you
  395.        can pass a command line to both Turbo Debugger and the program being
  396.        debugged.
  397.  
  398.      - Automatic error locating including /F Find Error.
  399.  
  400.      - Automatic restoration of the previous setup at startup.
  401.  
  402.  
  403.  
  404.  
  405.  
  406. Chapter 1 - Introduction To Pas-Ed                       Pas-Ed Manual - Page 2
  407.  
  408.  
  409.  
  410.  
  411.      - Keyboard macros with adjustable playback delay.
  412.  
  413.      - Inter-file block copy and move of text.
  414.  
  415.      - Block indent and unindent with adjustable spacing.
  416.  
  417.      - Find and replace using text from a marked block.
  418.  
  419.      - 10 placemarkers that operate within and between files, including files on
  420.        disk.
  421.  
  422.      - Jump to a specific file or line number.
  423.  
  424.      - Adjustable cursor size.
  425.  
  426.      - Pop-up ASCII character table (shows the ASCII character and its decimal,
  427.        hex, and binary values, plus, if the ASCII value is under 32, the control
  428.        code).
  429.  
  430.      - Pop-up extended key code table (shows the extended key codes of the
  431.        function keys, <Alt> + keys, arrow keys, etc.).
  432.  
  433.  
  434.  
  435. System Requirements
  436. ───────────────────
  437.  
  438. Hedco recommends that you run Pas-Ed on a computer system with at least 512k of
  439. DOS memory and a hard disk.  EMS memory is not required.  Pas-Ed will run on a
  440. high-capacity floppy disk system, but you should realize that DOS memory swaps
  441. will necessarily be slow if they must be made to disk.  Also, because Pas-Ed
  442. leaves such a small kernel in memory when swapped out, swap sizes will approach
  443. the amount of free DOS memory as reported by CHKDSK.  This could be a problem on
  444. floppy disk systems.  In the following example of a 720k floppy drive system,
  445. CHKDSK reports 451,328 bytes of free memory, which gives a good approximation of
  446. the size of the swap file:
  447.  
  448.      A:\>chkdsk
  449.  
  450.         730112 bytes total disk space
  451.          45056 bytes in 2 hidden files
  452.         214016 bytes in 7 user files
  453.         471040 bytes available on disk
  454.  
  455.         655360 bytes total memory
  456.         451328 bytes free
  457.  
  458. In the example, with only 471,040 bytes available on disk and a swap file size
  459. of close to 451,328 bytes, there will be almost no room left on the disk for the
  460.  
  461.  
  462.  
  463.  
  464. Chapter 1 - Introduction To Pas-Ed                       Pas-Ed Manual - Page 3
  465.  
  466.  
  467.  
  468.  
  469. compiled program and/or for using a disk link buffer after the swap file has
  470. been written to disk.  Systems with dual 720k floppy drives will necessarily
  471. need to use both drives, and lesser systems will be unable to run Pas-Ed.  If
  472. you are running Pas-Ed on a floppy disk system and have no EMS memory and only
  473. one or two edit window open, try turning EMS/Disk swapping off during DOS shells
  474. or when compiling very small programs.  Pas-Ed compresses the heap when EMS/Disk
  475. swapping is disabled, and exec sessions requiring minimal amounts of memory
  476. should operate without problem.  If you get insufficient memory messages, turn
  477. EMS/Disk swapping back on or close the second window if you have two windows
  478. open, and enable disk linking.
  479.  
  480.  
  481.  
  482. Before Running Pas-Ed
  483. ─────────────────────
  484.  
  485. Before running Pas-Ed, check: 1) the directory you plan to start Pas-Ed from
  486. (which may be different from the directory containing the Pas-Ed files); 2) the
  487. directory containing the TPC.EXE Turbo Pascal command line compiler; 3) the
  488. Pas-Ed directory; and 4) any directories on the DOS path.  What you're looking
  489. for are extra copies of the TPC.CFG compiler configuration file.  Delete any
  490. copies of this file found.  Pas-Ed will create an updated TPC.CFG file before
  491. compiles using your latest menu settings.  Extra copies of the TPC.CFG file
  492. which are further up the DOS path than the one Pas-Ed creates will be used by
  493. the compiler instead of the one created by Pas-Ed, causing unpredictable
  494. results.
  495.  
  496. Remember that you can specify a full path name for TPC.CFG, so you can instruct
  497. Pas-Ed to write the TPC.CFG file into the directory with the compiler and thus
  498. eliminate path problems altogether.
  499.  
  500.  
  501.  
  502. Contacting Hedco
  503. ────────────────
  504.  
  505. Pas-Ed is continually evolving to meet the needs of Pascal programmers.  As you
  506. use Pas-Ed, you'll undoubtedly think of additional features which Pas-Ed should
  507. have or changes that might enhance the program.  Please write Hedco with your
  508. suggestions or comments.  Our address is:
  509.  
  510.      Hedco, Inc.
  511.      P.O. Box 606
  512.      Tehachapi, CA 93581
  513.      USA
  514.  
  515.      Telephone: (805) 821-0167
  516.                 Monday through Friday, 9am to 5pm Pacific time
  517.  
  518.      On CompuServe: 76137,1656
  519.  
  520.  
  521.  
  522. Chapter 1 - Introduction To Pas-Ed                       Pas-Ed Manual - Page 4
  523.  
  524.  
  525.  
  526.  
  527.                      Chapter 2 - What's New In Version 1.4
  528.                      ─────────────────────────────────────
  529.  
  530.  
  531.  
  532. New Features
  533. ────────────
  534.  
  535. Because of the quickness of the update to version 1.4, this listing also
  536. contains the new features added to the previous version.
  537.  
  538. Pas-Ed version 1.4 contains a wealth of new features to make your Turbo Pascal
  539. programming easier.  All the new features were added at user request, and we
  540. encourage you to send us your suggestions on how to improve Pas-Ed.
  541.  
  542. The following is a list of the new features along with an explanation of their
  543. operation:
  544.  
  545.      - Pas-Ed now searches for the PAS-ED.CFG configuration file along the DOS
  546.        path so you can start Pas-Ed from any directory or drive as long as
  547.        you've properly set up the path.
  548.  
  549.      - Pas-Ed now has two Pick lists.  The original Pick list (the Memory-Files
  550.        Pick list) contained the files loaded in memory.  This Pick list is still
  551.        available through the Window/M-Pick menu option and from the editor via
  552.        <Alt-F3>.
  553.  
  554.        The new Pick list (the Recent-Files Pick list) contains the ten most
  555.        recently edited files, and is available through the File/R-Pick menu
  556.        option and from the editor via <Ctrl-F3>.  If the file chosen from this
  557.        list is in memory, Pas-Ed will switch to it, and if the file isn't in
  558.        memory, Pas-Ed will load the file into the current window and reposition
  559.        the cursor to where it was when the file was last being edited.  Like the
  560.        Memory-Files Pick list, this Pick list will jump into hidden windows.
  561.        This Pick list is saved in the PAS-ED.CFG configuration file and restored
  562.        at startup.
  563.  
  564.      - Pas-Ed's placemarkers now jump into disk files as well as in-memory
  565.        files.  If the file with the placemarker is in memory, Pas-Ed will switch
  566.        to it and reposition the cursor to where it was when the placemarker was
  567.        set, even if the file is in a different window from the one where the
  568.        placemarker was set or if the file has been hidden.  If the file isn't in
  569.        memory, Pas-Ed will load the file into the current window and reposition
  570.        the cursor.  In addition, the placemarkers are now saved in the
  571.        PAS-ED.CFG configuration file and restored at startup.
  572.  
  573.      - Pas-Ed now supports block indent and unindent via the ^KI and ^KU block
  574.        commands.  The number of spaces to indent or unindent can be set through
  575.        the Options/Indent/Unindent menu option, and is saved in the PAS-ED.CFG
  576.        configuration file and restored at startup.
  577.  
  578.  
  579.  
  580. Chapter 2 - What's New In Version 1.4                    Pas-Ed Manual - Page 5
  581.  
  582.  
  583.  
  584.  
  585.      - In the Options/Edit File Save selection, the "No" file save option has
  586.        been renamed to the more descriptive "Browse."  Note that Pas-Ed still
  587.        allows you to freely edit and cut and paste from a Browse file; Pas-Ed
  588.        will simply clear the edit buffer without saving the file when a new file
  589.        is loaded or when exiting Pas-Ed.  If necessary, a file save can be
  590.        forced with either the File/Save menu selection or the <F2> editing
  591.        command, and Pas-Ed will now verify a Browse file save before saving the
  592.        file.
  593.  
  594.      - Pas-Ed now enters the editor immediately after the opening screen and
  595.        automatically loads the files you were previously editing without cycling
  596.        the files through the File Name window.  Pas-Ed also accepts file names
  597.        as command line parameters, with ".PAS" as the default extension.  An
  598.        example would be:
  599.  
  600.             C>pas-ed file1 file2 file3.asm
  601.  
  602.        In this example, instead of loading your previous files, Pas-Ed would
  603.        load FILE1.PAS, FILE2.PAS, and FILE3.ASM.  If you specify more files than
  604.        can fit into available memory, Pas-Ed will load as many files as
  605.        possible.
  606.  
  607.      - Pas-Ed now returns directly to editor after actions which were initiated
  608.        by direct commands from the editor, such as the <Alt-F3> and <Ctrl-F3>
  609.        Pick lists, the <F9> make command, etc.
  610.  
  611.      - The "hot key" commands now work from everywhere in Pas-Ed including the
  612.        pop-up edit message and edit windows.
  613.  
  614.      - Pas-Ed returns directly to the menus after full DOS shells.  Single
  615.        command DOS shells still require the <Esc> key to be pressed, as this
  616.        allows you to see the on-screen results of the command before returning
  617.        to Pas-Ed.
  618.  
  619.      - The default NONAME file format has been changed to PAS-xxxx.PAS so that
  620.        the file names show up on default "*.PAS" directories.
  621.  
  622.      - The File/Clear command now changes the name in the current window to a
  623.        default PAS-xxxx.PAS file name after clearing the edit buffer to prevent
  624.        accidentally erasing a file.
  625.  
  626.      - The cursor size is now adjustable through the Options/Cursor Size option.
  627.  
  628.      - The editor's window commands have been expanded in a logical manner:
  629.  
  630.             - The <F3> command loads a file, and now <Alt-F3> calls up the
  631.               Memory-Files Pick list and <Ctrl-F3> the Recent-Files Pick list.
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638. Chapter 2 - What's New In Version 1.4                    Pas-Ed Manual - Page 6
  639.  
  640.  
  641.  
  642.  
  643.             - The <F4> command opens a window, and now <Alt-F4> closes the
  644.               current window.
  645.  
  646.             - The <F6> command rotates forward through the windows, and now
  647.               <Alt-F6> rotates backward through the windows.
  648.  
  649.      - There is a new Options/Verify Before Exit switch.  If this option is on
  650.        and you give an exit command, the "Verify exit" message appears and you
  651.        must verify the exit before Pas-Ed will exit to DOS.  If this option is
  652.        off, Pas-Ed immediately exits to DOS without verifying.
  653.  
  654.      - The available DOS and EMS memory are displayed in Options/Memory Usage
  655.        submenu.
  656.  
  657.      - Pas-Ed now has five user-selected utilities built into the menu system.
  658.        These utilities may be any executable or batch files, and are started via
  659.        the File/Utilities menu selection.  The names of the five utilities are
  660.        entered via the Options/Name User Utilities selection.  ".EXE" is the
  661.        default extension, and any file name entered without an extension will
  662.        have ".EXE' appended to it.  You may also enter a command line for each
  663.        utility which is then passed to the utility when it's called.  The names
  664.        of the utilities and their command lines are saved in the PAS-ED.CFG
  665.        configuration file and restored at startup.
  666.  
  667.      - Pas-Ed can now pass a command line to the file being run, and the command
  668.        line may be edited via the Language/Files submenu or just prior to the
  669.        run session.
  670.  
  671.      - Pas-Ed now passes a command line to Turbo Debugger, and the command line
  672.        may be edited via the Language/Files submenu or just prior to the debug
  673.        session.  Pas-Ed can also pass the Run Command Line to the program being
  674.        debugged.
  675.  
  676.      - Pas-Ed now has a project file, which can be edited via the Language/Files
  677.        submenu.  When entering the name of a file to compile, run, or debug or
  678.        when entering one of five the user utilities, the new <Alt-N> (for Name)
  679.        command switches the file name between the project file and the file in
  680.        the current window.
  681.  
  682.      - Also when entering the name of a file to compile, run, or debug or when
  683.        entering one of five the user utilities, the new <Alt-P> command switches
  684.        the directory path between the current directory, the Pas-Ed directory,
  685.        and the EXE/TPU directory.
  686.  
  687.      - The Unit, Include, and Object directories passed to the TPC.EXE compiler
  688.        have been expanded to 125 characters.
  689.  
  690.      - Pas-Ed's memory usage during DOS memory swaps has been reduced to just 6k
  691.        of DOS memory.
  692.  
  693.  
  694.  
  695.  
  696. Chapter 2 - What's New In Version 1.4                    Pas-Ed Manual - Page 7
  697.  
  698.  
  699.  
  700.  
  701.      - Pas-Ed now searches for the macro file along the path, and will change
  702.        the macro file name when found to include the correct path.
  703.  
  704.      - Pas-Ed now checks your file before saving for errant End-Of-File markers
  705.        that could result in the loss of the portions of your file that follow
  706.        the marker.  Any End-OF-File markers imbedded in the body of your source
  707.        code are changed to spaces.  End-Of-File markers in the source code form
  708.        of "^Z" and "#26" are not affected.
  709.  
  710.      - The default directory can now be changed via the File/New Dir option.
  711.  
  712.      - After a DOS shell, Pas-Ed automatically switches back to the default
  713.        directory.
  714.  
  715.      - The status line can now be recovered and used for editing via the
  716.        Options/Editor Status Line option.
  717.  
  718.      - The new <Alt-V> "hot key" toggles between 25 and 43/50 line screen modes
  719.        from either the editor or the menus.
  720.  
  721.      - Pas-Ed can now switch between 25 and 28 lines as the standard screen
  722.        height, providing your video system is in 28 line mode, using the
  723.        Options/Type of Monitor submenu.
  724.  
  725.      - The new <Alt-F1> "hot key" displays the last DOS screen.
  726.  
  727.      - When changing colors using the Color Chart, the down arrow now reduces
  728.        the byte color value and the up arrow increases it.
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754. Chapter 2 - What's New In Version 1.4                    Pas-Ed Manual - Page 8
  755.  
  756.  
  757.  
  758.  
  759.                          Chapter 3 - Setting Up Pas-Ed
  760.                          ─────────────────────────────
  761.  
  762.  
  763.  
  764. Pas-Ed Files
  765. ────────────
  766.  
  767. If you haven't already done so, make backup copies of the Pas-Ed files.  The
  768. complete Pas-Ed package includes the following files:
  769.  
  770.      PAS-ED.EXE    The Pas-Ed program.  This is the only file needed to run
  771.                    Pas-Ed.
  772.  
  773.      PAS-ED.MAC    The sample macro file.
  774.  
  775.      PAS-ED.MAN    The complete, on-disk manual (this file).
  776.  
  777.      PAS-ED.CFG    The Pas-Ed configuration file.  This file is NOT included in
  778.                    the Pas-Ed package, but is listed here for completeness.  It
  779.                    is created by Pas-Ed when you exit the program, and contains
  780.                    data representing the state of Pas-Ed upon exit.  It's used
  781.                    to restore your last setup when you restart Pas-Ed.
  782.  
  783. By default, Pas-Ed uses the following programs from Borland International to
  784. compile and debug Turbo Pascal programs:
  785.  
  786.      TPC.EXE       The Turbo Pascal compiler and library files.  These files are
  787.      TURBO.TPL     used to compile your source code files.
  788.  
  789.      TD.EXE        Turbo Debugger.
  790.  
  791.  
  792.  
  793. Getting Pas-Ed Ready
  794. ────────────────────
  795.  
  796. Those unfamiliar with setting up directories and paths and copying files should
  797. refer to your DOS or Turbo Pascal manuals.
  798.  
  799. The easiest way to set up Pas-Ed is to copy all the necessary Pas-Ed, compiler,
  800. and debugger files into the same directory.  If this isn't feasible, another
  801. method is to have the Pas-Ed, compiler, and debugger files in different
  802. directories and use DOS' PATH command to tell DOS where to look for the files.
  803. For example, if the compiler files were located on your hard disk drive C in the
  804. directory \TP, the command would be:
  805.  
  806.      PATH=C:\TP
  807.  
  808.  
  809.  
  810.  
  811.  
  812. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 9
  813.  
  814.  
  815.  
  816.  
  817. This command is best entered into your AUTOEXEC.BAT file, and you can specify
  818. several directories separated by ";", such as:
  819.  
  820.      PATH=C:\TP;C:\TD;D:\PAS-ED
  821.  
  822. If you've started Pas-Ed from a directory other than the one containing Pas-Ed,
  823. Pas-Ed will follow the path to find it's configuration file, and Pas-Ed either
  824. accepts full path names for the other files it needs or will follow the path to
  825. find them, allowing Pas-Ed to be started from any directory.
  826.  
  827.  
  828.  
  829. Starting Pas-Ed
  830. ───────────────
  831.  
  832. With Pas-Ed in the current directory or on the DOS path, type "PAS-ED" at the
  833. DOS prompt.  The program will load from disk and the Pas-Ed license menu will
  834. appear.  It will be necessary to accept the Pas-Ed License Agreement for the
  835. program to continue.  The Pas-Ed License Agreement is located in the preface of
  836. this manual.  This menu appears the first time Pas-Ed is started, and thereafter
  837. the program is entered directly.
  838.  
  839. Since this is the first time the program has been run, there's no PAS-ED.CFG
  840. configuration file for Pas-Ed to read to restore the prior setup.  A message to
  841. this effect appears, which, if you had previously run Pas-Ed and had created a
  842. configuration file, would alert you to possible corruption of the PAS-ED.CFG
  843. file so you could recheck your configuration settings.  Press <Esc> to clear the
  844. message, and the Pas-Ed copyright, trademark, and registration notice appears.
  845.  
  846. Press <Esc> to clear the notice, and you're immediately placed in the Pas-Ed
  847. editor.  If you're not starting Pas-Ed from the Pas-Ed directory and not using
  848. the DOS path to the Pas-Ed files, a message appears prior to the editor
  849. notifying you that an error has occurred loading the macro file.  This is
  850. normal, since Pas-Ed can't find the macro file in either the current directory
  851. or along the path and you haven't yet given Pas-Ed a macro file name with a full
  852. path attached.  Press <Esc> to clear this message and bring up the editor.
  853.  
  854. The editor is explained in greater detail in Chapter 6 - The Pas-Ed Editor.  For
  855. now, notice that the top line of the screen contains the editor's message line,
  856. and the bottom line contains the status line.  Notice also that the file name on
  857. the top line of the screen is of the format "PAS-xxxx.PAS".  This is Pas-Ed's
  858. default file format, and is used whenever Pas-Ed needs to open a new file.
  859. Pas-Ed will initially try the file PAS-1.PAS.  If this file exists in the
  860. current directory, Pas-Ed will open PAS-2.PAS, and if PAS-2.PAS exists, Pas-Ed
  861. will open PAS-3.PAS, etc.
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 10
  871.  
  872.  
  873.  
  874.  
  875. The Status Line
  876. ───────────────
  877.  
  878. The status line shows prompt or status information about Pas-Ed, and is always
  879. visible unless you've recovered this line for editing via the Options/Editor
  880. Status Line menu option, in which case the status line will appear only in the
  881. menu system.  The status line is broken into three sections:
  882.  
  883.      - At the far left is the number of the currently active window.  Since
  884.        window one is active, a "1" appears here.  If two windows were open and
  885.        the second window were active, a "2" would be displayed. If macro
  886.        recording were enabled, an "M" would be displayed next to the window
  887.        number.  Thus, if the fourth window was active and macro recording were
  888.        on, "4M" would be displayed.
  889.  
  890.      - In the middle is the prompt information about the system (menu or editor)
  891.        currently active.  Since the editor is active, this section displays
  892.        keyword explanations of the functions assigned to the function keys.  If
  893.        the menu system were active, this section would display prompt
  894.        information about the currently highlighted menu selection.
  895.  
  896.      - To the far right is the memory location of the active window.  If the
  897.        active window had been allocated in DOS memory, "DOS" would be displayed;
  898.        if in EMS memory, "EMS" would appear here.
  899.  
  900. Press <F10> to open the menu system.  The top line of the screen now contains
  901. Pas-Ed's main menu.  Since "Edit" is highlighted, the status line briefly
  902. explains the Edit menu option.
  903.  
  904.  
  905.  
  906. Navigating The Menu System
  907. ──────────────────────────
  908.  
  909. The menu system is navigated by using either the dedicated movement keys, such
  910. as the arrow, Home, and End keys, or WordStar commands, such as <Ctrl-S> for
  911. left, <Ctrl-D> for right, etc.  Pressing <Enter> when the light bar is over a
  912. selection or pressing its highlighted letter selects it, and <Esc> deselects or
  913. closes a menu.
  914.  
  915. Open the Options menu by pressing <Alt-O>.  All the main menu selections, such
  916. as File, Window, Edit, Search, etc., are "hot-keyed", meaning they can be
  917. selected from anywhere in Pas-Ed, including from the editor, by pressing the Alt
  918. key and the first letter of the selection.  (The only exceptions to this are the
  919. pop-up edit windows, since they use some of the hot keys for other commands.)
  920. Try out the menu hot keys at this time by pressing <Alt-E> to go back to the
  921. editor, then <Alt-O> to reopen the Options menu.
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 11
  929.  
  930.  
  931.  
  932.  
  933. The Options Menu
  934. ────────────────
  935.  
  936. The Options menu contains most of the selections needed to set up Pas-Ed.
  937.  
  938. At the top of the Options menu is "Config auto save."  If this selection is on,
  939. the PAS-ED.CFG configuration file is saved to disk whenever you exit the
  940. program.  The PAS-ED.CFG file allows Pas-Ed to restore your previous setup when
  941. you restart the program.  It's a good idea to leave this option on unless you
  942. have reason not to.
  943.  
  944. The next selection is "Edit file save."  This selection brings up a submenu with
  945. the choices "Auto", "Prompt", and "Browse."  These choices indicate how the file
  946. in the active window will be saved.  If Auto is selected and the file has been
  947. changed during the editing session, the file will automatically be saved prior
  948. to a DOS shell or a debug or run session or before exiting the program.  Prompt
  949. means you'll be prompted whether or not to save the file.  Browse means the file
  950. has been opened for browsing only and it won't be saved and you won't be
  951. prompted.  Note that the Browse selection doesn't prevent you from editing or
  952. copying to or from the file; it only means the file won't be saved.  You can
  953. force a file save if you wish using the File/Save menu option or <F2> from the
  954. editor.  Pas-Ed will confirm the save before saving the file.
  955.  
  956. After you've made a selection, a submenu appears asking whether you want the
  957. change to be effective for just the current window or for all windows.  Each
  958. window can have its own setting.  Pressing <Esc> cancels the change.
  959.  
  960. In most cases, Auto is the best choice, although Browse is quite useful when
  961. cutting and pasting routines from one of your library files.  If you set this
  962. selection to Browse, remember to reset it once you resume normal editing in the
  963. window, or else your editing changes won't be saved and you won't be prompted.
  964.  
  965. You may be wondering why changed files are saved prior to DOS shells, debug and
  966. run sessions, and when running the user utilities.  The reason is that these are
  967. the types of sessions where there's a good chance of a system crash, such as
  968. when debugging or running a new program that has an undiscovered fatal bug,
  969. which would cause you to lose all your editing changes.
  970.  
  971. The next selection on the Options menu is "Backup file," which determines
  972. whether a ".BAK" file is created when the current file is saved.  This option is
  973. usually best left on unless speed and/or disk space are factors, and here too
  974. each window can have its own setting.
  975.  
  976. Next is "Macro auto save," which determines whether the in-memory macros are
  977. automatically saved to disk prior to exiting the program.  This option is also
  978. generally best left on.
  979.  
  980. Next is "verify before eXit."  If this option is on, Pas-Ed verifies that you
  981. want to exit before it exits to DOS; if off, Pas-Ed immediately exits to DOS
  982. without verifying.
  983.  
  984.  
  985.  
  986. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 12
  987.  
  988.  
  989.  
  990.  
  991. Next is "cuRsor size," which allows you to set the cursor size for the editing
  992. and DOS shell windows.  The options are Block, Fat, and Normal.
  993.  
  994. Now press <U> for "memory Usage," which opens the Memory Usage submenu.  This
  995. submenu determines how Pas-Ed will use the available DOS and EMS memory.  The
  996. first selection on the Memory Usage submenu, "Swap to EMS/disk," determines
  997. whether Pas-Ed will swap a DOS memory image to EMS memory or disk prior to a DOS
  998. shell or a compile, debug, or run session or when running a user utility.  If
  999. enabled, Pas-Ed swaps out of memory and frees up all but 6K of DOS memory for
  1000. the session.  If off, the heap is compressed and a standard DOS exec session is
  1001. initiated with whatever DOS memory is available (the amount of available DOS
  1002. memory will depend primarily on the number of windows you've opened and whether
  1003. you've allocated any new macros).
  1004.  
  1005. The second selection on the Memory Usage submenu, "Reserve EMS for swap,"
  1006. determines whether enough EMS memory will be reserved to hold a DOS memory swap.
  1007. If your system doesn't have EMS memory or if there's not enough EMS memory
  1008. available for the swap, Pas-Ed will prevent you from enabling this option and
  1009. the reason will be displayed in a pop-up window.
  1010.  
  1011. The third selection on the Memory Usage submenu, "Working memory", allows you to
  1012. specify the amount of DOS memory, in bytes, that Pas-Ed sets aside for internal
  1013. program use.  The default is 20,000 bytes, which should prove sufficient for
  1014. most situations.  This figure may have to be adjusted upward if your setup of
  1015. Pas-Ed uses a significant amount of working memory, such as if you've defined
  1016. numerous macros, opened a lot of windows, or are making large EMS-to-EMS block
  1017. copies and moves, etc.  (Since only one EMS-based file can be mapped into DOS
  1018. memory at once, EMS-to-EMS block transfers are temporarily stored in working
  1019. memory.)  If you get insufficient memory messages, then raise the amount of
  1020. working memory.
  1021.  
  1022. Press <Esc> to return to the Options menu, then <S> for "Screen colors."  The
  1023. Screen Colors submenu appears, displaying all the program color types.  An arrow
  1024. is displayed next to the Screen Colors submenu showing which color type is
  1025. currently selected.  Use the arrow, Home, and End keys to choose a color type to
  1026. change, then press <Enter>.
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 13
  1045.  
  1046.  
  1047.  
  1048.  
  1049. The Color Chart
  1050. ───────────────
  1051.  
  1052. ────────────────────────────────────────────────────────────────────────────────
  1053.  
  1054.    File  Window  Edit  Search  Macros  Compile  Run  Debug  Language  Options
  1055. ┌───────────────────────┐           ╔════════════════════════════════════════╗─┐
  1056. │ Normal text color     │<════════  ║   ┌─ New Value ─┐     ┌─ Old Value ─┐  ║ │
  1057. │ Highlighted text      │           ║   │       7     │     │       7     │  ║ │
  1058. │ Marked text block     │           ║   └─────────────┘     └─────────────┘  ║ │
  1059. │ Text error message    │           ║   ┌────────── Color Chart ──────────┐  ║ │
  1060. │ Normal background     │           ║   │   0   1   2   3   4   5   6   7 │  ║ │
  1061. │ Status line color     │           ║   │   8   9  10  11  12  13  14  15 │  ║ │
  1062. │ Normal menu color     │           ║   │  16  17  18  19  20  21  22  23 │  ║ │
  1063. │ Highlighted menu      │           ║   │  24  25  26  27  28  29  30  31 │  ║ │
  1064. │ Selected menu item    │           ║   │  32  33  34  35  36  37  38  39 │  ║ │
  1065. │ Menu border color     │           ║   │  40  41  42  43  44  45  46  47 │  ║ │
  1066. │ Menu title color      │           ║   │  48  49  50  51  52  53  54  55 │  ║─┘
  1067. │ Normal message color  │           ║   │  56  57  58  59  60  61  62  63 │  ║
  1068. │ Highlighted message   │           ║   │  64  65  66  67  68  69  70  71 │  ║
  1069. │ Selected message item │           ║   │  72  73  74  75  76  77  78  79 │  ║
  1070. │ Message border color  │           ║   │  80  81  82  83  84  85  86  87 │  ║
  1071. │ Message title color   │           ║   │  88  89  90  91  92  93  94  95 │  ║
  1072. │ Normal help color     │           ║   │  96  97  98  99 100 101 102 103 │  ║
  1073. │ Highlighted help      │           ║   │ 104 105 106 107 108 109 110 111 │  ║
  1074. │ Selected help item    │           ║   │ 112 113 114 115 116 117 118 119 │  ║
  1075. │ Help border color     │           ║   │ 120 121 122 123 124 125 126 127 │  ║
  1076. │ Help title color      │           ║   └─────────────────────────────────┘  ║
  1077. └───────────────────────┘           ╚════════════════════════════════════════╝
  1078.  
  1079. ────────────────────────────────────────────────────────────────────────────────
  1080.  
  1081. The color chart appears, showing the possible color combinations and their byte
  1082. values.  At the top of the color chart are two boxes showing the old and new
  1083. byte values of the selected color type.  Use the arrow, Home, and End keys to
  1084. change the color value, noticing that the change is reflected in both the new
  1085. color value box and the Screen Colors submenu.  The status line gives a brief
  1086. explanation of how the new color value is incremented or decremented depending
  1087. on which key is pressed.  Pressing <Enter> selects the new color, while <Esc>
  1088. restores the original window colors.
  1089.  
  1090. When all the program color types are changed to your liking, press <Esc> to exit
  1091. the Screen Colors submenu.  The menu and message colors are changed immediately.
  1092. A submenu appears asking whether you want the text color changes to be effective
  1093. for just the current window or for all windows.  Each window can have its own
  1094. color settings.  Pressing <Esc> changes the text color in just the current
  1095. window.
  1096.  
  1097. Return to the Options menu and press <T> to bring up the "Type of monitor"
  1098. submenu.  The first selection, "Color monitor," forces Pas-Ed to treat your
  1099.  
  1100.  
  1101.  
  1102. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 14
  1103.  
  1104.  
  1105.  
  1106.  
  1107. video system as either color or monochrome.  Most of the time, Pas-Ed will
  1108. accurately detect the type of video system in use and adjust for it.  Some video
  1109. systems are not what they appear to Pas-Ed, however, such as a monochrome LCD
  1110. display monitor connected to a CGA display adapter (common on portable
  1111. computers).  Under such circumstances, you may find it necessary to reset this
  1112. option.
  1113.  
  1114. The second selection, "Suppress snow," is important only if you have an older
  1115. CGA system.  Early model CGAs display "snow" during untimed direct screen
  1116. writes, which is how Pas-Ed writes to the screen by default.  If you notice snow
  1117. on your screen, set this option on.  The resulting screen writes will be
  1118. slightly slower but free of snow.
  1119.  
  1120. The third selection, "43/50 rows," resets the video mode to 43 screen lines if
  1121. you have an EGA system or 50 screen lines for a VGA.  If you don't have one of
  1122. these systems, a message to that effect appears and this option can't be
  1123. enabled.  Note that 43/50 line mode can also be toggled via the <Alt-V> hot key.
  1124.  
  1125. The fourth selection, "standard Rows," switches between 25 and 28 rows as the
  1126. standard screen size.  Your computer must be in 28 row mode to display 28 lines
  1127. on your screen; otherwise, you're prevented from enabling this option.
  1128.  
  1129.  
  1130.  
  1131. The User Utilities
  1132. ──────────────────
  1133.  
  1134. From the Options menu, press <N> for Name User Utilities.  The Name User
  1135. Utilities submenu appears, which allows you to enter the names of five programs
  1136. which can be run from the menu system via the File/Utility selection.  The
  1137. programs may be any executable or batch files, and are run in a DOS exec session
  1138. similar to the compile, debug, and run sessions.  Pas-Ed will either swap itself
  1139. out of memory or compress the heap depending on the Options/Memory Usage submenu
  1140. settings.
  1141.  
  1142. Either an ".EXE," ".COM," or ".BAT" extension is necessary for proper operation
  1143. of the utilities, and Pas-Ed will append ".EXE" to any file name entered without
  1144. an extension or without one of the above extensions.  For example, if C:\PAS-ED
  1145. was the current directory and you entered
  1146.  
  1147.      READ.ME
  1148.  
  1149. Pas-Ed would return the file name
  1150.  
  1151.      READ.EXE
  1152.  
  1153. To prepend one of the three logical directories (the current directory, the
  1154. Pas-Ed directory, and the EXE & TPU directory), use the <Alt-P> Path command
  1155. to switch between the logical directories.  To enter the project file, use the
  1156. <Alt-N> Name command to change the file name.
  1157.  
  1158.  
  1159.  
  1160. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 15
  1161.  
  1162.  
  1163.  
  1164.  
  1165. Next the command line for the utility is edited.  The command line is passed to
  1166. the utility when it's run, and each utility has a separate command line.
  1167.  
  1168. After you've edited the user utilities and their command lines, press <Esc> to
  1169. return to the Options menu.  The last selection on the Options menu is the
  1170. "editor status Line" option.  When enabled, the status line is displayed across
  1171. the bottom row of the screen in the editor; when disabled, the bottom line is
  1172. used for editing.  This option doesn't affect the display of the status line in
  1173. the menu system.  You might wish to leave this option enabled until you become
  1174. familiar with the Pas-Ed editor.
  1175.  
  1176.  
  1177.  
  1178. Setting Up The Macros
  1179. ─────────────────────
  1180.  
  1181. Press <Alt-M> to open the Macros menu.  Macros are on by default.  If you don't
  1182. wish to use macros, turn macro processing off by pressing <T> for "Turn on/off."
  1183. If you do use macros, you may want to reset the macro playback delay via the
  1184. Macro Delay selection.  This option controls the number of milliseconds paused
  1185. between keystrokes when a macro playback is in progress.  The default is 0.
  1186.  
  1187.  
  1188.  
  1189. Setting Up The Files
  1190. ────────────────────
  1191.  
  1192. Press <Alt-L> to open the Language menu, then <F> to open the "Files" submenu.
  1193. The "Files" submenu contains the file names and command lines Pas-Ed will use
  1194. during DOS shells and compile and debug sessions.  You may enter any compiler,
  1195. compiler configuration, or debugger file names (of course, they should correctly
  1196. name an appropriate program or file).  The default names are TPC.EXE for the
  1197. compiler, TPC.CFG for the compiler configuration file, and TD.EXE for the
  1198. debugger.  As with all menu options, the names are saved in the PAS-ED.CFG
  1199. configuration file and restored at startup.
  1200.  
  1201. The "deBugger commands" option allows you to edit a command line which is passed
  1202. to Turbo Debugger when initiating debug sessions.  The Turbo Debugger command
  1203. line options are explained in detail in your Turbo Debugger manuals.  One common
  1204. use to this option is to pass source code and EXE/TPU directories to Turbo
  1205. Debugger.  If you don't wish to pass a command line to the debugger, leave this
  1206. line blank.
  1207.  
  1208. The "Run command line" option allows you to edit a command line which is passed
  1209. to the program being run (via the Run selection on the main menu).  This is
  1210. useful for passing test parameters to programs.  This command line is also
  1211. passed to programs being debugged.  If you don't wish to pass a command line to
  1212. the program, leave this line blank.
  1213.  
  1214. Check these options to be sure they're correct, and change them if necessary.
  1215.  
  1216.  
  1217.  
  1218. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 16
  1219.  
  1220.  
  1221.  
  1222.  
  1223. Setting Up Turbo Pascal
  1224. ───────────────────────
  1225.  
  1226. Press <Esc> to return to the Language menu.  The first selection on the Language
  1227. menu, "Compiler," sets the Turbo Pascal compiler switches.  The second option,
  1228. "Linker," sets the Turbo Pascal linker switches.  The "Directories" selection
  1229. determines the directories where Turbo Pascal will look for the various files it
  1230. needs during compilation and where the resulting compiled files will be placed.
  1231. These options are the same as those in the Turbo IDE, and you should refer to
  1232. your Turbo Pascal manuals and Chapter 5 - The Pas-Ed Menu System if you need
  1233. further information.
  1234.  
  1235.  
  1236.  
  1237. Ready To Go
  1238. ───────────
  1239.  
  1240. Pas-Ed is now ready to run.  If you're familiar with the Turbo IDE, you should
  1241. be able to run Pas-Ed with little problem.  For an overview of running Pas-Ed,
  1242. please read the next chapter, Chapter 4 - A Tour of  Pas-Ed.
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276. Chapter 3 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 17
  1277.  
  1278.  
  1279.  
  1280.  
  1281.                          Chapter 4 - A Tour of Pas-Ed
  1282.                          ────────────────────────────
  1283.  
  1284.  
  1285.  
  1286. Getting Ready
  1287. ─────────────
  1288.  
  1289. This chapter illustrates most of Pas-Ed's main features in tutorial fashion.
  1290.  
  1291. If you're in Pas-Ed, make sure the Options/Config Auto Save menu option is on,
  1292. then exit Pas-Ed by pressing <Alt-X>.  <Alt-X> works from anywhere in Pas-Ed
  1293. except the pop-up edit windows.  Once you've exited Pas-Ed and are at the DOS
  1294. prompt, type "PAS-ED" to restart Pas-Ed.
  1295.  
  1296.  
  1297.  
  1298. Restoring Your Setup
  1299. ────────────────────
  1300.  
  1301. Since you created a PAS-ED.CFG configuration file when you exited Pas-Ed, Pas-Ed
  1302. automatically restores your previous menu settings and colors, then loads the
  1303. files you were editing and repositions the cursor in each file to where it was
  1304. when you exited Pas-Ed.
  1305.  
  1306. Had you passed file name(s) to Pas-Ed as command line parameters, Pas-Ed would
  1307. load those files instead of your previous files, using ".PAS" as the default
  1308. extension.  To try this, exit Pas-Ed by pressing <Alt-X>, then type
  1309.  
  1310.      pas-ed file1 file2 file3.asm
  1311.  
  1312. at the DOS prompt.  Instead of loading your previous files, Pas-Ed loads
  1313. FILE1.PAS, FILE2.PAS, and FILE3.ASM.  If you specify more files than can fit
  1314. into available memory, Pas-Ed will load as many files as possible.
  1315.  
  1316.  
  1317.  
  1318. The Editor
  1319. ──────────
  1320.  
  1321. As soon as the files are loaded, Pas-Ed places you in the editor.  The editor
  1322. uses the WordStar command set, and is virtually identical to the editor in the
  1323. Turbo IDE.  Try typing a few lines to get a feel for it.  If you forget an
  1324. editing command, press <F1> to bring up the help window.
  1325.  
  1326. One of the most useful and overlooked editing commands is the undo line change
  1327. command.  Move up or down a line, type some changes, then type <Ctrl-Q><L> (for
  1328. Quick-Line).  The line is restored to its original form.  This command works as
  1329. long as you haven't erased or moved off the line.
  1330.  
  1331.  
  1332.  
  1333.  
  1334. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 18
  1335.  
  1336.  
  1337.  
  1338.  
  1339. The top line of the edit window shows the state of the editor and is explained
  1340. in greater detail in Chapter 6 - The Pas-Ed Editor.  For now, try pressing the
  1341. Caps Lock, Num Lock, and Scroll Lock keys and note how they affect this line.
  1342.  
  1343. The status (or bottom) line shows, from left to right, the window number, the
  1344. commands associated with the function keys, and the location of the edit buffer
  1345. for the active window ("DOS" or "EMS").
  1346.  
  1347. Now press <F2> to save the file.  <F2> immediately saves the file unless the
  1348. Options/Edit File Save menu option is set to Browse, in which case you must
  1349. verify the file save before Pas-Ed will save the file.
  1350.  
  1351. Press <F4> to open a new window.  The File Name window reappears, only this time
  1352. the file you specify will be loaded into a new window.  The new window number is
  1353. visible in the lower left corner of the screen.  This number always shows the
  1354. window number of the file being acted upon.  Enter a file name and the window
  1355. will be created and the file loaded.
  1356.  
  1357. Note that, if you're editing the same file in two different windows, you're
  1358. actually editing two separate copies of the file, and changes made in one window
  1359. aren't being made to the text in the other window.
  1360.  
  1361. <Alt-F4> performs the opposite function of <F4> and closes the current window.
  1362. Press <Alt-F4>, and the current window is closed and its memory deallocated.  If
  1363. the file in the window has been changed, it's saved before the window is closed
  1364. according to the setting of its Options/Edit File Save parameter.  Press <F4>
  1365. and reopen the window.
  1366.  
  1367. Press <F3> to load a new file, entering a name into the File Name window.  If
  1368. it's a new file, Pas-Ed verifies that you actually wanted to create a new file
  1369. and didn't just make a typing mistake.
  1370.  
  1371. <Alt-F3> also switches files but uses the Memory-Files Pick list.  This Pick
  1372. list contains the names of all the files currently loaded in memory.  Press
  1373. <Alt-F3> the see the list, then choose a file.  Pas-Ed immediately switches to
  1374. the selected file.
  1375.  
  1376. <Ctrl-F3> switches files as well but uses the Recent-Files Pick list.  This Pick
  1377. list contains the names of the last ten files you've edited, with the most
  1378. recent files at the top of the list.  File names are not duplicated on the list;
  1379. if you jump to a file which was half way down the Pick list, the file name is
  1380. simply moved to the top of the list.  For now, select a file that's not
  1381. currently in memory, and Pas-Ed will reload the file into the current window and
  1382. reposition the cursor to where it was when you exited the file.
  1383.  
  1384. Press <F5> and the active window is reduced to half screen (unzoomed).  Press
  1385. <F5> again and the window is restored to full screen (zoomed).
  1386.  
  1387. Now press <F6> several times to rotate through the open windows.  Similarly,
  1388. press <Alt-F6> to rotate backwards through the windows.
  1389.  
  1390.  
  1391.  
  1392. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 19
  1393.  
  1394.  
  1395.  
  1396.  
  1397. Type something and mark a block in each window.  (<Ctrl-K><B> marks the
  1398. beginning of a block and <Ctrl-K><K> marks the end.)  Using the F5 and F6 keys,
  1399. switch and zoom/unzoom the windows until both windows and blocks are visible on
  1400. the screen.  Press <Ctrl-K><C> to copy the block in the active window to the
  1401. cursor position.  Now press <F7> and copy the block from the other window to the
  1402. cursor position.  Move the cursor and press <Ctrl-K><V> to move the block in the
  1403. active window to the cursor position.  Now press <F8> and move the block from
  1404. the other window to the cursor position.  Note that both <F7> and <F8> can copy
  1405. and move blocks from any window, including the current window, and will also
  1406. copy and move the block regardless of whether it's highlighted (^KH switches
  1407. block highlighting).
  1408.  
  1409. If your printer is connected to the LPT1 parallel printer port 1 and turned on,
  1410. use <Ctrl-K><P> to print the block in the active window.
  1411.  
  1412. Type a nonsense word to ensure the file won't compile properly.  Press <F9> to
  1413. make (compile) the file.  Pas-Ed will either swap a DOS memory image to EMS/disk
  1414. or compresses the heap depending on the setting of the Options/Memory Usage
  1415. submenu, then call the compiler to compile the file.  If you get an out of
  1416. memory message, change the Options/Memory Usage/Swap To EMS/Disk menu setting to
  1417. on, then recompile the file.  The compiler will find the error, and Pas-Ed will
  1418. automatically load and/or switch to the file with the error, then position the
  1419. cursor at the source of the error, highlight it, and display the error message.
  1420. Pressing the <Alt-D> hot key to clear the error message and select the Debug
  1421. option.
  1422.  
  1423.  
  1424.  
  1425. Switching Exec Files and Directories
  1426. ────────────────────────────────────
  1427.  
  1428. Pas-Ed automatically loads the file name from the current window as the file to
  1429. debug.  Now switch the file name between the file in the active window and the
  1430. project file by pressing <Alt-N> (for Name).  This command works in the Compile,
  1431. Debug, and Run File Name windows, and when entering the name of a user utility.
  1432.  
  1433. Let's assume you're using the DOS path to run Pas-Ed, and your Pas-Ed files are
  1434. in one directory, you've started Pas-Ed from a second directory, and your EXE
  1435. and TPU files are in a third directory via the Language/Directories/EXE & TPU
  1436. Directory menu setting.  How do you switch between the three directories without
  1437. typing in a complete path name every time you compile, run, or debug a program?
  1438. Pas-Ed provides a simple solution.
  1439.  
  1440. Let's assume the directory shown isn't the correct directory.  Instead of typing
  1441. in a new path, press <Alt-P> (for Path), and Pas-Ed automatically switches the
  1442. path name between the three logical paths.
  1443.  
  1444. The <Alt-P> command works in the Compile, Debug, and Run File Name windows, and
  1445. when entering the name of a user utility.
  1446.  
  1447.  
  1448.  
  1449.  
  1450. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 20
  1451.  
  1452.  
  1453.  
  1454.  
  1455. To see the last DOS screen, press <Alt-F1>.  The screen is cleared by pressing
  1456. any key.  This option is especially useful to review compiler error messages
  1457. when using Pas-Ed to write programs in other languages, such as when writing
  1458. assembler routines.
  1459.  
  1460.  
  1461.  
  1462. The Window Menu
  1463. ────────────────
  1464.  
  1465. Press <Alt-W> to open the Window menu.  Press <H> to hide the active window.
  1466. Now press <Alt-E> to return to the editor, then <F6> several times to rotate
  1467. through the windows and verify that the window has been hidden.  Press <Alt-W>
  1468. to reopen the Window menu, then <U> for Unhide.  A menu appears with a list of
  1469. all the hidden windows, and you can either pick one to unhide or press <Esc> to
  1470. cancel.  Press <Esc> to cancel, then <M> for M-Pick.  The Memory-Files Pick list
  1471. appears, with hidden windows clearly marked as such and the active window
  1472. prefaced by "√".  This Pick list selects a new active window.  Select the hidden
  1473. window as the new active window, and it is immediately unhidden and becomes the
  1474. active window.  Verify that the window is unhidden by using <F6> to rotate
  1475. through the windows.  Note that the Memory-Files Pick list is also available via
  1476. the <Alt-F3> hot key.
  1477.  
  1478. Press <Ctrl-F3> and the Recent-Files Pick list appears, displaying the ten most
  1479. recently edited files.  This Pick list is also available via the File/R-Pick
  1480. menu option, and will jump into and unhide hidden windows.
  1481.  
  1482. From the Window menu, press <C> for Close, and the active window is closed and
  1483. removed from memory.  Now try to close the remaining windows, and Pas-Ed will
  1484. prevent the last window from begin closed.  At least one window must always be
  1485. open.  Press <O> and reopen the closed windows.  Now close and reopen the window
  1486. using the <Alt-F4> and <F4> hot keys.
  1487.  
  1488. The remaining entries on the Window menu rotate forward and backward through the
  1489. file rotation and zoom and unzoom the windows, similar to the F5 and F6 keys in
  1490. the editor.
  1491.  
  1492.  
  1493.  
  1494. The Search Menu
  1495. ───────────────
  1496.  
  1497. Press <Alt-S> to open the Search menu.  This menu enables you to search and move
  1498. quickly through the files.  The Find and Replace menu selections are the same as
  1499. the <Ctrl-Q><F> (Quick Find) and <Ctrl-Q><A> (Quick Find and Replace) WordStar
  1500. commands.  The Find Next and Replace Next menu selections are the same as
  1501. Wordstar's <Ctrl-L>.  The Find Block and Replace Block menu selections load the
  1502. search string with up to 30 characters from the marked block in the active
  1503. window, although not across line breaks.  Since there's a marked block in the
  1504. active window, press <I>, then <E> from the Search menu to try these selections.
  1505.  
  1506.  
  1507.  
  1508. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 21
  1509.  
  1510.  
  1511.  
  1512.  
  1513. From the Search menu, press <G> for Goto line.  Enter a line number and Pas-Ed
  1514. jumps to the specified line.  If the line number is greater than the number of
  1515. lines in the file, Pas-Ed jumps to the end of the file.
  1516.  
  1517. Press <S> to set a placemarker.  You have ten placemarkers, 0-9.  Press <5> to
  1518. set placemarker 5 at the current cursor position in the current file.  The
  1519. placemarkers don't have to be set in any particular order.  Press <Alt-W> to
  1520. open the Window menu and <N> to rotate to the next window.  Then press <Alt-S>
  1521. to open to the Search menu, <J> for Jump To Placemarker, then enter <5>.  Pas-Ed
  1522. jumps to the proper file and line number.  These commands are also available
  1523. from the editor.  Press <F6> to rotate to the other file.  Press <Ctrl-K><1> to
  1524. set placemarker 1, then jump back and forth between the two files by pressing
  1525. <Ctrl-Q><5> and <Ctrl-Q><1>.
  1526.  
  1527.  
  1528.  
  1529. The Macro Menu
  1530. ──────────────
  1531.  
  1532. Press <Alt-M> to open the Macro menu.  Through this menu, Pas-Ed can record and
  1533. playback keystrokes.  The Macro menu is fairly self-explanatory, and you should
  1534. have no trouble using the macros.  For good measure, though, we'll record, edit,
  1535. and delete a macro.
  1536.  
  1537. Press <R> to record a macro.  A message appears reminding you how to turn macro
  1538. recording off.  Press <Esc> to clear the message, then <Alt-E> to enter the
  1539. editor.  Notice the "M" next to the window number in the lower left corner of
  1540. the screen, indicating that macro recording is on.  Typing carefully (trust us),
  1541. type the letter "c", no more, no less, then press <Alt-F10> to turn macro
  1542. recording off.   Pas-Ed asks for a key to associate the macro with.  Enter
  1543. <Alt-B>, then enter "Bad Macro" as the name for the macro.
  1544.  
  1545. Try out the macro by pressing <Alt-B>.  Instead of inserting "c" into the file,
  1546. the Compile menu opens.  To see why, press <Alt-M> to open the Macro menu, then
  1547. <E> to edit a macro, and choose "Bad Macro" as the macro to edit.  Press <Enter>
  1548. to accept the macro name, and the Edit Macro window appears with Bad Macro
  1549. displayed.  The macro should be shown as "<AltE>c".  As you can see, all
  1550. keystrokes after macro recording was turned on were faithfully recorded,
  1551. including keystrokes that perhaps we didn't want, such as the <Alt-E> command we
  1552. used to return to the editor.  When we started Bad Macro by pressing <Alt-B>,
  1553. Bad Macro first selected the Edit menu with <Alt-E>, then selected the Compile
  1554. menu with <c>.  You should edit all macros after they've been recorded to remove
  1555. unwanted keystrokes.
  1556.  
  1557. While still in the Edit Macro window, press the Home and End keys.  Instead of
  1558. moving the cursor to the beginning and end of the line, <Home> and <End> are
  1559. inserted into the macro.  In order to use these keys to maneuver around the Edit
  1560. Macro window, you must use the <Scroll Lock> key to toggle between command and
  1561. literal interpretation.  Try out the macro editor, in particular noticing how
  1562.  
  1563.  
  1564.  
  1565.  
  1566. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 22
  1567.  
  1568.  
  1569.  
  1570.  
  1571. the extended keys, such as Home, End, Insert, Delete, Backspace, etc., are
  1572. handled depending on whether the editor is in Command or Literal mode.
  1573.  
  1574. Use the <Scroll Lock> key to be sure you're in Command mode, then either press
  1575. <Enter> to accept the edited macro or <Esc> to restore the original macro.  Then
  1576. press <D> for Delete, and delete Bad Macro.
  1577.  
  1578.  
  1579.  
  1580. The Other Menus
  1581. ───────────────
  1582.  
  1583. The other menus are concerned mostly with setting up and running Pas-Ed and
  1584. Turbo Pascal.  The selections are either easily understood by programmers
  1585. familiar with Turbo Pascal or are explained in Chapter 3 - Setting Up Pas-Ed,
  1586. Chapter 5 - The Pas-Ed Menu System, or in your Turbo Pascal manuals.
  1587.  
  1588.  
  1589.  
  1590. The Pop-up Tables
  1591. ─────────────────
  1592.  
  1593. Two of Pas-Ed's handiest features are the pop-up ASCII and extended key code
  1594. tables, which will save you the considerable time and trouble most programmers
  1595. spend looking up this information.  Press <Alt-E> to return to the editor, then
  1596. <Alt-A> to bring up the ASCII table, and <Alt-K> to bring up the extended Key
  1597. code tables.
  1598.  
  1599.  
  1600.  
  1601. Switching Video Modes
  1602. ─────────────────────
  1603.  
  1604. Press <Alt-V> to switch between standard and 43/50 screen line modes.  If your
  1605. display has 43/50 line capability, it's immediately switched into 43/50 line
  1606. mode; otherwise, a message informing you that your display doesn't have this
  1607. ability appears.  If your video display mode was successfully switched, press
  1608. <Alt-V> to switch it back.  This command is available from anywhere in Pas-Ed
  1609. except the pop-up edit windows.
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624. Chapter 4 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 23
  1625.  
  1626.  
  1627.  
  1628.  
  1629.                       Chapter 5 - The Pas-Ed Menu System
  1630.                       ──────────────────────────────────
  1631.  
  1632.  
  1633.  
  1634. About the Menus
  1635. ───────────────
  1636.  
  1637. Pas-Ed's menus are similar in style to those in the Turbo IDE.  The main menu
  1638. displays horizontally across the top row of the screen, with pull-down submenus
  1639. opening vertically below.  All selections on the main menu are "hot keyed" and
  1640. can be selected from anywhere in Pas-Ed (except from the pop-up message windows,
  1641. which require a specific response such as <Y>, <N>, or <Esc>) by holding down
  1642. the <Alt> key and pressing the first letter of the selection. For example, to
  1643. open the File menu, press <Alt-F>, and to select Run, press <Alt-R>.
  1644.  
  1645. Moving around the menu system is accomplished by using either the dedicated
  1646. movement keys, such as the arrow, Home, and End keys, or WordStar commands, such
  1647. as <Ctrl-S> for left, <Ctrl-D> for right, <Ctrl-E> for up, <Ctrl-X> for down,
  1648. etc.  Pressing <Enter> or <Ctrl-M> when the light bar is over a selection or
  1649. pressing its highlighted letter selects it.  Pressing <Esc> or <Ctrl-[>
  1650. deselects or closes a menu.
  1651.  
  1652. To assist you in choosing the proper menu options, each individual selection has
  1653. a brief descriptive prompt displayed in the status line.
  1654.  
  1655.  
  1656.  
  1657. The Menu Selections
  1658. ───────────────────
  1659.  
  1660. This section describes the operation and function of each menu selection.  The
  1661. menu selections are:
  1662.  
  1663. File
  1664. ────
  1665. Displays the File menu.  The File menu selections are:
  1666.  
  1667.      Load
  1668.      ────
  1669.      Loads a file into the active window.  If the requested file is already
  1670.      loaded in another window, you're given the choice of either switching to
  1671.      that window or going ahead and loading the file into the active window.
  1672.      The file which was already in the window is saved according to the setting
  1673.      of the window's Edit File Save toggle (see the Options menu).  The Load
  1674.      option can also be selected from the editor by <F3>.
  1675.  
  1676.      R-Pick
  1677.      ──────
  1678.      Displays the Recent-Files Pick list (a list of the ten most recently edited
  1679.  
  1680.  
  1681.  
  1682. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 24
  1683.  
  1684.  
  1685.  
  1686.  
  1687.      files) and allows you to select one to edit.  If the selected file isn't in
  1688.      memory, the file will be loaded into the active window and the cursor
  1689.      repositioned to where it was when the file was last being edited.  If the
  1690.      selected file is in memory, Pas-Ed will switch to the window containing the
  1691.      file even if the window is hidden.  If the window was hidden, it remains
  1692.      hidden; as soon as you leave the window, it's removed again from the window
  1693.      rotation.  This option can be selected from the editor by <Ctrl-F3>.
  1694.  
  1695.      Clear
  1696.      ─────
  1697.      Deletes all data from the active window without saving and resets the file
  1698.      name to a default PAS-xxxx.PAS name.  You're asked to confirm this action.
  1699.  
  1700.      Save
  1701.      ────
  1702.      Immediately saves the file in the active window unless the Edit File Save
  1703.      toggle is set to Browse, in which case you're asked to confirm the save.
  1704.  
  1705.      save All
  1706.      ────────
  1707.      Saves all changed files according to the setting of their window's Edit
  1708.      File Save toggles.
  1709.  
  1710.      Write to
  1711.      ────────
  1712.      Writes the file in the active window to a file you specify.
  1713.  
  1714.      Dir
  1715.      ───
  1716.      Display a directory based on a directory mask you specify.
  1717.  
  1718.      New Dir
  1719.      ───────
  1720.      Changes the current directory.  Note that the current directory cannot be
  1721.      changed in a DOS shell, as Pas-Ed switches back to the current directory
  1722.      after the DOS shell is completed.
  1723.  
  1724.      OS shell
  1725.      ────────
  1726.      Runs the DOS command you specify.  If no command is given, the screen is
  1727.      cleared and the DOS prompt appears.  Pas-Ed is re-entered by typing "EXIT"
  1728.      at the DOS prompt.  If EMS/disk swapping is enabled, the contents of memory
  1729.      are swapped out to EMS or disk prior to the DOS shell; otherwise, the heap
  1730.      is compressed and the shell is run with whatever DOS memory is available.
  1731.  
  1732.      Utilities
  1733.      ─────────
  1734.      Displays the User Utilities submenu and runs the user utility you specify.
  1735.      Pas-Ed allows you to enter five utility names and command lines into the
  1736.  
  1737.  
  1738.  
  1739.  
  1740. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 25
  1741.  
  1742.  
  1743.  
  1744.  
  1745.      menu system via the Options/Name User Utilities selection.  These utilities
  1746.      must be valid EXE, COM, or BAT files and must be located either in the same
  1747.      directory as Pas-Ed or on the DOS path or have a full path included.  These
  1748.      five utilities can then be run as part of the Pas-Ed IDE.  When run, if
  1749.      EMS/disk swapping is enabled, the contents of memory are swapped out to EMS
  1750.      or disk and the utility is run; otherwise, the heap is compressed.
  1751.  
  1752.      Exit
  1753.      ────
  1754.      Exits Pas-Ed and returns to DOS.  The files being edited are saved
  1755.      according to their window's Edit File Save toggles.  If the Config Auto
  1756.      Save and/or Macro Auto Save toggles are on, the configuration and/or macro
  1757.      files are saved.  See the Options menu for an explanation of these toggles.
  1758.      This option can be selected from anywhere in Pas-Ed except the pop-up
  1759.      message windows by pressing <Alt-X>.
  1760.  
  1761.  
  1762. Window
  1763. ──────
  1764. Displays the Window menu.  The Window menu selections are:
  1765.  
  1766.      Open
  1767.      ────
  1768.      Opens a new edit window if sufficient memory is available.  Windows are
  1769.      allocated first in DOS memory, then in EMS memory.  Up to 21 windows may be
  1770.      opened.  This option is available from the editor by <F4>.
  1771.  
  1772.      Close
  1773.      ─────
  1774.      Closes the active window and deallocates it memory.  If the file in the
  1775.      active window has been changed during the editing session, it's saved
  1776.      according to the setting of the window's Edit File Save toggle (see the
  1777.      Options menu).  This option is available from the editor by <Alt-F4>.
  1778.  
  1779.      M-Pick
  1780.      ──────
  1781.      Displays the Memory-Files Pick list (a list of all files loaded in the
  1782.      windows) and allows you to select one as the active window.  If the
  1783.      selected window is hidden, it is unhidden.  This option is available from
  1784.      the editor by <Alt-F3>.
  1785.  
  1786.      Next
  1787.      ────
  1788.      Selects the next unhidden window as the active window.  This option is
  1789.      available from the editor by <F6>.
  1790.  
  1791.      Back
  1792.      ────
  1793.      Selects the previous unhidden window as the active window.  This option is
  1794.      available from the editor by <Alt-F6>.
  1795.  
  1796.  
  1797.  
  1798. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 26
  1799.  
  1800.  
  1801.  
  1802.  
  1803.      Zoom
  1804.      ────
  1805.      Resizes the active window to either full screen (zoomed) or half screen
  1806.      (unzoomed).  Note that at least one window must always be zoomed.  This
  1807.      option is available from the editor by <F5>.
  1808.  
  1809.      Hide
  1810.      ────
  1811.      Hides the active window.  The data in the hidden window remains intact and
  1812.      the file save routines operate normally.  The window is simply removed from
  1813.      the window rotation.  This is useful if, for example, you have all 21
  1814.      windows open but are editing only 3 files; this option allows you to hide
  1815.      the other 18 windows.  Hidden windows may be unhidden with either the
  1816.      Window/Unhide or Window/M-Pick commands.  Note that at least one window
  1817.      must be unhidden.
  1818.  
  1819.      Unhide
  1820.      ──────
  1821.      Displays a list of all hidden windows and allows you to select one to
  1822.      unhide.
  1823.  
  1824.  
  1825. Edit
  1826. ────
  1827. Erases the menus, displays the active window, and calls the editor.
  1828.  
  1829.  
  1830. Search
  1831. ──────
  1832. Displays the Search menu.  The Search menu selections are:
  1833.  
  1834.      Find
  1835.      ────
  1836.      Finds the search string using the search options you specify.
  1837.  
  1838.      fInd block
  1839.      ──────────
  1840.      Loads the search string with up to 30 characters from the marked block in
  1841.      the active window.  Characters are not loaded across line breaks.
  1842.  
  1843.      fiNd next
  1844.      ─────────
  1845.      Finds the next occurrence of the search string using the previous search
  1846.      options.
  1847.  
  1848.      Replace
  1849.      ───────
  1850.      Finds the search string and replaces it with the replacement string using
  1851.      the replace options you specify.
  1852.  
  1853.  
  1854.  
  1855.  
  1856. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 27
  1857.  
  1858.  
  1859.  
  1860.  
  1861.      rEplace block
  1862.      ─────────────
  1863.      Loads the search string with up to 30 characters from the marked block in
  1864.      the active window.  Characters are not loaded across line breaks.
  1865.  
  1866.      rePlace next
  1867.      ────────────
  1868.      Finds the next occurrence of the search string and replaces it with the
  1869.      replacement string using the previous replace options.
  1870.  
  1871.      Goto line
  1872.      ─────────
  1873.      Moves the cursor to the line number you specify.
  1874.  
  1875.      Set marker
  1876.      ──────────
  1877.      Sets the placemarker you specify (0 to 9) to the current cursor position in
  1878.      the current file.
  1879.  
  1880.      Jump to marker
  1881.      ──────────────
  1882.      Jumps to the placemarker you specify (0 to 9) even in the file containing
  1883.      the placemarker has been moved to disk or if the file is now in a different
  1884.      window from the window where the placemarker was set or if the window
  1885.      containing the file is hidden.  Jumping into a hidden window doesn't unhide
  1886.      it; as soon as you leave the window, it's removed again from the window
  1887.      rotation.  If there are 2 windows containing the same file, Pas-Ed jumps to
  1888.      the first one.
  1889.  
  1890.  
  1891. Macros
  1892. ──────
  1893. Displays the Macro menu.  The Macro menu selections are;
  1894.  
  1895.      Playback
  1896.      ────────
  1897.      Plays back the macro you specify.
  1898.  
  1899.      Record
  1900.      ──────
  1901.      Begins recording keystrokes into a macro.
  1902.  
  1903.      record Off
  1904.      ──────────
  1905.      Stops recording keystrokes and asks for a key to associate the macro with
  1906.      as well as a name for the macro.  This is the same as pressing <Alt-F10>
  1907.      from within the editor.  After a macro has been recorded, you should edit
  1908.      the macro to remove any keystrokes associated with setting up the macro.
  1909.      Pas-Ed automatically removes the keystrokes that turned macro recording on
  1910.      and off.
  1911.  
  1912.  
  1913.  
  1914. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 28
  1915.  
  1916.  
  1917.  
  1918.  
  1919.      Load
  1920.      ────
  1921.      Loads a macro file, replacing the macros in memory with the macros from the
  1922.      file.
  1923.  
  1924.      Merge
  1925.      ─────
  1926.      Merges the macros from a macro file with the macros in memory.  If the
  1927.      current macro file is then saved after the merge, it will include the
  1928.      merged macros.
  1929.  
  1930.      Save
  1931.      ────
  1932.      Writes the macros in memory to the current macro file.
  1933.  
  1934.      list
  1935.      ────
  1936.      Lists the macros in memory.
  1937.  
  1938.      Edit
  1939.      ────
  1940.      Edits an in-memory macro.
  1941.  
  1942.      Delete
  1943.      ──────
  1944.      Deletes an in-memory macro and deallocate its memory.
  1945.  
  1946.      delete All
  1947.      ──────────
  1948.      Deletes all in-memory macros and deallocates their memory.  You're asked to
  1949.      confirm this action.
  1950.  
  1951.      macro delaY
  1952.      ───────────
  1953.      Adjust the delay between keystrokes when a macro is played back.  The delay
  1954.      is in milliseconds and can be any number between 0 and 255.
  1955.  
  1956.      Turn on/off
  1957.      ───────────
  1958.      Enables and disables macro processing.  Macro processing is on by default.
  1959.      When disabled, all macros are deleted and their memory deallocated.  When
  1960.      re-enabled, the macros in the current macro file are reloaded into memory.
  1961.  
  1962.  
  1963. Compile
  1964. ───────
  1965. Displays the Compile menu.  The Compile menu selections are:
  1966.  
  1967.      Compile
  1968.      ───────
  1969.      The selected file is compiled.  No other units used by the program which
  1970.  
  1971.  
  1972. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 29
  1973.  
  1974.  
  1975.  
  1976.  
  1977.      have existing TPU files are recompiled even if their source code has been
  1978.      changed since they were last compiled.
  1979.  
  1980.      Make
  1981.      ────
  1982.      The selected file is compiled along with all units used by the program
  1983.      whose source code has changed since they were last compiled.
  1984.  
  1985.      Build
  1986.      ─────
  1987.      The selected file and all units used by the program are compiled.  This
  1988.      option ensures that all TPU files are up to date.
  1989.  
  1990.      Production build
  1991.      ────────────────
  1992.      The selected file and all units used by the program are compiled using your
  1993.      regular compiler settings, except no debug information is generated and
  1994.      stack and range checking are turned off.  This option ensures that all TPU
  1995.      files are up to date.
  1996.  
  1997.      Auto config file
  1998.      ────────────────
  1999.      Enables and disables automatic creation of a compiler configuration file.
  2000.      When enabled, an updated compiler configuration file is written to disk
  2001.      prior to every compile; if disabled, no compiler configuration file is
  2002.      written.  The default name for the configuration file is TPC.CFG, which can
  2003.      be changed using the Language/Files submenu.
  2004.  
  2005.      Find error
  2006.      ──────────
  2007.      Locate the source code location of a run-time error if you have its hex
  2008.      location.  For example, a runtime range error might result in the message
  2009.      "Runtime error 201 at 3C08:023B."  By entering the hex number "3C08:023B"
  2010.      as the error location and recompiling the file, Pas-Ed will automatically
  2011.      locate and display the line in the source code that caused the error.
  2012.  
  2013.  
  2014. Run
  2015. ───
  2016. Run a program from within Pas-Ed.  If EMS/disk swapping is enabled, a DOS memory
  2017. image is swapped out to EMS or disk prior to the program run.
  2018.  
  2019.  
  2020. Debug
  2021. ─────
  2022. Debug a program from within Pas-Ed.  If EMS/disk swapping is enabled, a DOS
  2023. memory image is swapped out to EMS or disk prior to the debug session.
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 30
  2031.  
  2032.  
  2033.  
  2034.  
  2035. Language
  2036. ────────
  2037. Displays the Language menu.  The Language menu selections are:
  2038.  
  2039.      Compiler
  2040.      ────────
  2041.      Displays the Compiler submenu, which contains the options for the Turbo
  2042.      Pascal compiler.  The Compiler submenu selections are:
  2043.  
  2044.           Align data
  2045.           ──────────
  2046.           Align variables and typed constants on byte or word boundaries.
  2047.           Generally, byte alignment takes less memory while word alignment runs
  2048.           faster.
  2049.  
  2050.           Boolean evaluation
  2051.           ──────────────────
  2052.           Switch between complete and short circuit boolean evaluation, which
  2053.           determines whether boolean expressions are evaluated completely or
  2054.           terminated as soon as possible.
  2055.  
  2056.           Conditional defines
  2057.           ───────────────────
  2058.           Allows you to enter conditional compilation directives which can be
  2059.           referenced in the source code.
  2060.  
  2061.           Debug information
  2062.           ─────────────────
  2063.           Displays the Debug menu.  The Debug menu selections are:
  2064.  
  2065.                Append debug info to EXE
  2066.                ────────────────────────
  2067.                Enables and disables the appending of debug information to the
  2068.                compiled EXE file.  This information is necessary to use Turbo
  2069.                Debugger on your program.  The extent of the debugging
  2070.                information appended depends on the following two settings:
  2071.  
  2072.                Make line-number table
  2073.                ──────────────────────
  2074.                Enables and disables the generation of a source code line-number
  2075.                table.  This table allows Turbo Debugger to step through the
  2076.                source code line by line during a debugging session.  Unless this
  2077.                option is enabled, Turbo Debugger steps through your program at
  2078.                the CPU (assembly) level.
  2079.  
  2080.                Include local symbols
  2081.                ─────────────────────
  2082.                Enables and disables the generation of debug information for
  2083.                local symbols, which are the names and types of all local (as
  2084.                opposed to global) variables and constants.
  2085.  
  2086.  
  2087.  
  2088. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 31
  2089.  
  2090.  
  2091.  
  2092.  
  2093.           Force far calls
  2094.           ───────────────
  2095.           Enables and disables the use of the FAR code model by all procedures
  2096.           and functions.
  2097.  
  2098.           I/O Checking
  2099.           ────────────
  2100.           Enables and disables the generation of code to check for input/output
  2101.           errors.
  2102.  
  2103.           Memory sizes
  2104.           ────────────
  2105.           Displays the Memory Size submenu.  The selections on the Memory Size
  2106.           submenu are:
  2107.  
  2108.                Stack size
  2109.                ──────────
  2110.                Set the stack size in decimal bytes.
  2111.  
  2112.                Low heap limit
  2113.                ──────────────
  2114.                Set the minimum required heap size in decimal bytes.
  2115.  
  2116.                High heap limit
  2117.                ───────────────
  2118.                Set the maximum heap size in decimal bytes.
  2119.  
  2120.           Numeric processing
  2121.           ──────────────────
  2122.           Displays the Numeric Processing submenu.  The selections are:
  2123.  
  2124.                Emulation
  2125.                ─────────
  2126.                Enables and disables linking of the 8087 emulation library.  This
  2127.                library uses the 8087 math coprocessor if present and emulates it
  2128.                if not.
  2129.  
  2130.                Numeric processing
  2131.                ──────────────────
  2132.                Switches between inline 8087 code, which allows the use of
  2133.                single, double, extended, and comp real types, and the use of
  2134.                software-only (6 byte) reals.  Note that if inline 8087 code is
  2135.                enabled, you must either link in the 8087 emulation library (see
  2136.                the option above) or the computers on which the program is run
  2137.                must have an 80x87 math coprocessor.
  2138.  
  2139.           Overlays allowed
  2140.           ────────────────
  2141.           Enables and disables the generation of overlay code.  Units compiled
  2142.           with this option on do not have to be overlayed.
  2143.  
  2144.  
  2145.  
  2146. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 32
  2147.  
  2148.  
  2149.  
  2150.  
  2151.           Range checking
  2152.           ──────────────
  2153.           Enables and disables the generation of code to check the bounds on
  2154.           arrays, strings, and scalar-type variables.
  2155.  
  2156.           Stack checking
  2157.           ──────────────
  2158.           Enables and disables the generation of code to check for stack
  2159.           overflow.
  2160.  
  2161.           Var-string checking
  2162.           ───────────────────
  2163.           Enables and disables checking of declared string parameters against
  2164.           the actual passed parameter.  If this option is on and the declared
  2165.           and actual string parameters are not identical, a compiler error
  2166.           occurs.
  2167.  
  2168.      Linker
  2169.      ──────
  2170.      Displays the Linker submenu.  The selections are:
  2171.  
  2172.           Link buffer
  2173.           ───────────
  2174.           Switch between using a disk or memory link buffer.  Linking to memory
  2175.           is faster but the linker may run out of memory on larger programs.
  2176.           Linking to disk is slower but larger programs can be linked.
  2177.  
  2178.           Map file
  2179.           ────────
  2180.           Sets the amount of information that goes into the map file (typically
  2181.           used by 3rd party debuggers).  The selections are:
  2182.  
  2183.                None
  2184.                ────
  2185.                No map file is generated.
  2186.  
  2187.                Segments
  2188.                ────────
  2189.                Only segment information is generated.
  2190.  
  2191.                Publics
  2192.                ───────
  2193.                Segment information plus all symbol names and addresses and the
  2194.                location of the program's entry point are generated.
  2195.  
  2196.                Detailed
  2197.                ────────
  2198.                Publics information plus line-number and module tables are
  2199.                generated.
  2200.  
  2201.  
  2202.  
  2203.  
  2204. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 33
  2205.  
  2206.  
  2207.  
  2208.  
  2209.      Directories
  2210.      ───────────
  2211.      Displays the Directories submenu, which contains the paths to the various
  2212.      files needed by the Turbo Pascal compiler.  The Directory submenu
  2213.      selections are:
  2214.  
  2215.           Turbo directory
  2216.           ───────────────
  2217.           The compiler will search the current directory and the directory
  2218.           specified here for the TURBO.TPL compiler library file.
  2219.  
  2220.           EXE & TPU directory
  2221.           ───────────────────
  2222.           The compiler will put the compiled EXE and TPU files in the directory
  2223.           specified here.  If no directory is specified, the compiled files will
  2224.           go in the directory with the source code file.
  2225.  
  2226.           Include directories
  2227.           ───────────────────
  2228.           The compiler will search the current directory and the directories
  2229.           specified here for the files listed with the Include {$I Filename}
  2230.           compiler directive.
  2231.  
  2232.           Unit directories
  2233.           ────────────────
  2234.           The compiler will search the current directory and the directories
  2235.           specified here for units used by the files being compiled.
  2236.  
  2237.           Object directories
  2238.           ──────────────────
  2239.           The compiler will search the current directory and the directories
  2240.           specified here for the object files listed with the {$L Filename}
  2241.           compiler directive.
  2242.  
  2243.      Files
  2244.      ─────
  2245.      Displays the Files submenu, which contains the names of the various files
  2246.      called by Pas-Ed during operation.  The Files submenu selections are:
  2247.  
  2248.           Compiler file name
  2249.           ──────────────────
  2250.           The file Pas-Ed will call to compile files.  ".EXE" is the default
  2251.           extension, and any file name you enter without an extension will have
  2252.           ".EXE" appended to it.
  2253.  
  2254.           conFigure file name
  2255.           ───────────────────
  2256.           The compiler configuration file.  This is the file Pas-Ed will write
  2257.           the Turbo Pascal compiler and linker switches to if the Auto Config
  2258.           File option is enabled (see the Compile menu).  ".CFG" is the default
  2259.           extension.
  2260.  
  2261.  
  2262. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 34
  2263.  
  2264.  
  2265.  
  2266.  
  2267.           Debugger file name
  2268.           ──────────────────
  2269.           The file Pas-Ed will call to debug files.  ".EXE" is the default
  2270.           extension.
  2271.  
  2272.           deBugger commands
  2273.           ─────────────────
  2274.           The command line passed to the debugger.  As an example, this option
  2275.           would allow you to pass a list of source and EXE/TPU directories to
  2276.           Turbo Debugger.  For more information on the command line options
  2277.           offered by Turbo Debugger, consult your manuals.
  2278.  
  2279.           Run command line
  2280.           ────────────────
  2281.           The command line passed to the program being run via the Run selection
  2282.           on the main menu.  As an example, this option would allow you to pass
  2283.           command line test parameters to the program being run.
  2284.  
  2285.           Pas-Ed config file
  2286.           ──────────────────
  2287.           The Pas-Ed configuration file.  The default file name is PAS-ED.CFG
  2288.           and cannot be changed.  This file is stored by default in the same
  2289.           directory as PAS-ED.EXE, although Pas-Ed will find the file in any
  2290.           directory as long as it's on the DOS path.
  2291.  
  2292.           Macro file name
  2293.           ──────────────────
  2294.           The name of the currently loaded macro file.  This file can be changed
  2295.           using the Macro/Load menu option.
  2296.  
  2297.  
  2298. Options
  2299. ───────
  2300. Displays the Options menu.  The Options menu selections are:
  2301.  
  2302.      Config auto save
  2303.      ────────────────
  2304.      Enables and disables automatic saving of the PAS-ED.CFG configuration file
  2305.      upon exit.  This file contains a description of Pas-Ed's last setup.  At
  2306.      startup, Pas-Ed looks for this file in the Pas-Ed directory and uses it to
  2307.      restore colors and menu settings and reload the files you were last using.
  2308.  
  2309.      Edit file save
  2310.      ──────────────
  2311.      Switches between automatic, prompted, and Browse file save status.  If set
  2312.      to Auto, the file is automatically saved if it has been changed during the
  2313.      editing session.  If set to Prompt, you're prompted whether or not to save
  2314.      the file.  If set to Browse, the file isn't saved and you're not prompted.
  2315.      You're given the choice of applying the new setting to just the active
  2316.      window or to all windows.
  2317.  
  2318.  
  2319.  
  2320. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 35
  2321.  
  2322.  
  2323.  
  2324.  
  2325.      Backup files
  2326.      ────────────
  2327.      Enables and disables the creation of backup files when saving your source
  2328.      code files.  You're given the choice of applying the new setting to just
  2329.      the active window or to all windows.
  2330.  
  2331.      Macro auto save
  2332.      ───────────────
  2333.      Enables and disables automatic saving of the macro file when exiting.
  2334.  
  2335.      Write config file
  2336.      ─────────────────
  2337.      Writes the PAS-ED.CFG configuration file to disk using the current
  2338.      settings.
  2339.  
  2340.      memory Usage
  2341.      ────────────
  2342.      Displays the Memory Usage submenu.  The selections are:
  2343.  
  2344.           Swap to EMS/Disk
  2345.           ────────────────
  2346.           Enables and disables swapping of a DOS memory image to expanded memory
  2347.           (EMS) or disk prior to a DOS shell or a compile, debug, or run
  2348.           session.  If enabled, more memory is freed up than would otherwise be
  2349.           available; however, this must be balanced against the time penalty
  2350.           imposed by the swap.  On systems with EMS memory, the time penalty is
  2351.           minimal and this option can be left enabled.  Systems requiring disk
  2352.           swaps, and in particular swaps to a floppy disk, might want to disable
  2353.           this option during simple DOS shells, providing enough DOS memory is
  2354.           available for the exec session.
  2355.  
  2356.           Reserve EMS for swap
  2357.           ────────────────────
  2358.           Enables and disables the reservation of enough EMS memory to hold a
  2359.           DOS memory swap.  If enabled, enough 16k (16,384 byte) blocks of EMS
  2360.           memory are set aside for the swap.
  2361.  
  2362.           Working memory
  2363.           ──────────────
  2364.           Sets the amount of DOS memory reserved by Pas-Ed for internal purposes
  2365.           such as screen saves, macros, EMS-to-EMS block moves, etc.  By
  2366.           adjusting this value, sufficient memory can be reserved to allow
  2367.           proper functioning of the program while leaving as much memory as
  2368.           possible for the edit buffers.  The default value is 20,000 bytes, and
  2369.           may be changed to any value between 16,384 and 65,535.
  2370.  
  2371.           If you encounter memory allocation failure messages, simply increase
  2372.           this number and then exit and restart Pas-Ed.
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 36
  2379.  
  2380.  
  2381.  
  2382.  
  2383.           DOS buffers open
  2384.           ────────────────
  2385.           Displays the number of edit windows opened in DOS memory.
  2386.  
  2387.           EMS buffers open
  2388.           ────────────────
  2389.           Displays the number of edit windows opened in EMS memory.
  2390.  
  2391.           Total buffers open
  2392.           ──────────────────
  2393.           Displays the total number of open windows.
  2394.  
  2395.           Edit buffer size
  2396.           ────────────────
  2397.           Displays the size in bytes of the edit buffers (all edit buffers are
  2398.           the same size).
  2399.  
  2400.           EMS/Disk Swap Size
  2401.           ──────────────────
  2402.           Displays the exact size in bytes of the DOS memory swap.
  2403.  
  2404.           EMS reserved for swap
  2405.           ─────────────────────
  2406.           Displays the amount of expanded memory (EMS) reserved for the DOS
  2407.           memory swap.  Since EMS memory is allocated in 16k (16,384 byte)
  2408.           blocks, this figure has been rounded up to the next 16k block unless
  2409.           by coincidence your memory swap size is exactly divisible by 16k.
  2410.  
  2411.           Dos Memory Available
  2412.           ─────────────────────
  2413.           Displays the amount of available DOS memory.
  2414.  
  2415.           Ems Memory Available
  2416.           ─────────────────────
  2417.           Displays the amount of available EMS memory.
  2418.  
  2419.      Screen colors
  2420.      ─────────────
  2421.      Displays the Screen Colors submenu, which allows you to change the screen
  2422.      colors.  The functioning of the Screen Colors submenu is explained in
  2423.      detail in Chapter 3 - Setting Up Pas-Ed.
  2424.  
  2425.      The types of screen colors fall into 5 general categories:
  2426.  
  2427.           Text colors
  2428.           ───────────
  2429.           There are four text color types: Normal, Highlighted, Marked Block,
  2430.           and Error, which are the colors used when displaying the editing
  2431.           windows.  Normal is the regular text color, Highlighted for the
  2432.           message line, Marked Block for marked blocks, and Error for error
  2433.           messages.
  2434.  
  2435.  
  2436. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 37
  2437.  
  2438.  
  2439.  
  2440.  
  2441.           General screen colors
  2442.           ─────────────────────
  2443.           There are two general screen color types: Screen Background and Status
  2444.           Line.  Screen Background is used when not in the editor or menu
  2445.           systems, such as during DOS shells, compiles, etc.  Status Line is
  2446.           used for the bottom row of the screen except for the function key
  2447.           displays, which use Menu Highlighted.
  2448.  
  2449.           Menu colors
  2450.           ───────────
  2451.           There are five menu color types: Normal, Highlighted, Selected,
  2452.           Border, and Title.  Normal is the regular menu color, Highlighted for
  2453.           selection letters, Selected for the moving light bar, Border for the
  2454.           menu border, and Title for menu headers.
  2455.  
  2456.           Message colors
  2457.           ──────────────
  2458.           The five message color types are the same as the five menu colors
  2459.           types except they're used to display general messages.
  2460.  
  2461.           Help colors
  2462.           ───────────
  2463.           The five help color types are the same as the five menu colors types
  2464.           except they're used to display help messages.
  2465.  
  2466.      Default screen colors
  2467.      ─────────────────────
  2468.      Resets the screen colors to their default values.  You're asked to confirm
  2469.      this action.  You have the choice of restoring the default colors in just
  2470.      the active window or in all windows.  Pressing <Esc> changes the colors in
  2471.      just the current window.
  2472.  
  2473.      Type of monitor
  2474.      ───────────────
  2475.      Displays the Monitor submenu.  The selections are:
  2476.  
  2477.           Color monitor
  2478.           ─────────────
  2479.           Forces Pas-Ed to treat your video display as either color or
  2480.           monochrome.
  2481.  
  2482.           Suppress snow
  2483.           ────────────
  2484.           Suppresses snow on older CGA displays at the expense of somewhat
  2485.           slower screen writes.
  2486.  
  2487.           43/50 rows
  2488.           ──────────
  2489.           Allows EGA/VGA systems to display 43/50 screen rows respectively.  The
  2490.           default is 25 rows.
  2491.  
  2492.  
  2493.  
  2494. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 38
  2495.  
  2496.  
  2497.  
  2498.  
  2499.           standard Rows
  2500.           ─────────────
  2501.           Switches between using 25 and 28 rows as the standard screen display.
  2502.           Your computer must be in 28 screen line mode for this option to take
  2503.           effect; otherwise, it does nothing.
  2504.  
  2505.      View last DOS screen
  2506.      ────────────────────
  2507.      Displays the last DOS screen, which would be either the screen when Pas-Ed
  2508.      was started or the screen during a DOS shell or a compile, debug, or run
  2509.      session.  This option is particularly useful to view compiler errors.
  2510.  
  2511.      Name user utilities
  2512.      ───────────────────
  2513.      Displays the Name User Utility submenu, which allows you to enter the names
  2514.      and command lines of the five user-selected utilities.  These utilities can
  2515.      then be run from the File/Utility menu selection.
  2516.  
  2517.      editor status Line
  2518.      ──────────────────
  2519.      Switches between using the bottom screen row in the editor for the status
  2520.      line or an editing line.
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552. Chapter 5 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 39
  2553.  
  2554.  
  2555.  
  2556.  
  2557.                          Chapter 6 - The Pas-Ed Editor
  2558.                          ─────────────────────────────
  2559.  
  2560.  
  2561.  
  2562. About the Editor
  2563. ────────────────
  2564.  
  2565. Turbo Pascal programmers should have little trouble adapting to Pas-Ed's editor,
  2566. as it uses the same command set as the Turbo IDE.  Pas-Ed's windows operate much
  2567. like Sidekick's, and on-line help is available through the <F1> key.
  2568.  
  2569. Because of the editor's similarity to the Turbo IDE editor, and since Pas-Ed
  2570. users are assumed to be familiar with Turbo Pascal and to have the Turbo Pascal
  2571. manuals, the description of the editor is brief.
  2572.  
  2573.  
  2574.  
  2575. The Editor Message Line
  2576. ───────────────────────
  2577.  
  2578. ────────────────────────────────────────────────────────────────────────────────
  2579.  
  2580.       Line 1    Col 1   Insert Indent Tab D:TESTFILE.PAS  Scr Num CAP BAK Auto
  2581.  
  2582. ────────────────────────────────────────────────────────────────────────────────
  2583.  
  2584. Above is an example of the editor message line, which appears at the top of each
  2585. text window and shows the status of the editor for that particular window.  Each
  2586. window can have different settings except for the keyboard status toggles, which
  2587. are the same for all windows.  The message line entries are:
  2588.  
  2589.      Line             The line number on which the cursor is located.
  2590.  
  2591.      Col              The column number in which the cursor is located.
  2592.  
  2593.      Insert           If visible, indicates that characters are being inserted
  2594.                       into the text buffer.  If off, characters are overwriting
  2595.                       the existing text.  This option is toggled by <Ctrl-V> or
  2596.                       <Insert>.
  2597.  
  2598.      Indent           If visible, indicates that new lines will be indented to
  2599.                       the level of the line above.  If off, new lines start at
  2600.                       Column 1.  This option is toggled by <Ctrl-Q><I>.
  2601.  
  2602.      Tab              If visible, indicates that fixed, 8-column tabs are
  2603.                       enabled.  If off, tabs are set at the first letter of the
  2604.                       words on the line above.  This option is toggled by
  2605.                       <Ctrl-O><T>.
  2606.  
  2607.  
  2608.  
  2609.  
  2610. Chapter 6 - The Pas-Ed Editor                            Pas-Ed Manual - Page 40
  2611.  
  2612.  
  2613.  
  2614.  
  2615.      D:TESTFILE.PAS   The name of the file being edited.  Note that the full
  2616.                       path name is not displayed.
  2617.  
  2618.      Scr              If visible, indicates that the Scroll Lock key is on.
  2619.  
  2620.      Num              If visible, indicates that the Num Lock key is on.
  2621.  
  2622.      CAP              If visible, indicates that the Caps Lock key is on.
  2623.  
  2624.      BAK              If visible, indicates that a backup file will be made when
  2625.                       the file in the active window is saved.
  2626.  
  2627.      Auto             Displays the status of the Options/Edit File Save menu
  2628.                       option.  If "Auto" is displayed, then the file in the
  2629.                       active window will automatically be saved.  "Prompt" means
  2630.                       you'll be prompted whether or not to save the file, and
  2631.                       "Browse" means the file won't be saved and you won't be
  2632.                       prompted.
  2633.  
  2634.  
  2635.  
  2636. The Editor Status Line
  2637. ──────────────────────
  2638.  
  2639. ────────────────────────────────────────────────────────────────────────────────
  2640.  
  2641. 2M   F1Help F2Save F3Load F4Open F5Zoom F6Next F7Copy F8Move F9Make F10Menu  DOS
  2642.  
  2643. ────────────────────────────────────────────────────────────────────────────────
  2644.  
  2645. Above is an example of the editor status line.  From left to right, the "2"
  2646. indicates that the number 2 edit window is active.  The "M" next to the "2"
  2647. means that macro recording is on.  In the middle are the function keys along
  2648. with a keyword description of their function.  The "DOS" on the far right
  2649. indicates that the active window has been allocated in DOS memory.  If the
  2650. active window had been allocated in EMS memory, "EMS" would be displayed.
  2651.  
  2652. The editor status line can be toggled off and the bottom row recovered for
  2653. editing via the Options/Editor Status Line selection.
  2654.  
  2655.  
  2656.  
  2657. The Function Keys
  2658. ─────────────────
  2659.  
  2660. The functions assigned to the function keys are:
  2661.  
  2662.      <F1>      - Help.
  2663.                  Displays a help menu, from which the various editing commands
  2664.                  can be displayed.
  2665.  
  2666.  
  2667.  
  2668. Chapter 6 - The Pas-Ed Editor                            Pas-Ed Manual - Page 41
  2669.  
  2670.  
  2671.  
  2672.  
  2673.      <Alt-F1>  - View last DOS screen.
  2674.                  Displays the last DOS screen.  Pressing any key clears the
  2675.                  screen.
  2676.  
  2677.      <F2>      - Save.
  2678.                  Saves the file in the active window to disk.
  2679.  
  2680.      <F3>      - Load.
  2681.                  Loads a new file into the active window.
  2682.  
  2683.      <Alt-F3>  - Memory-Files Pick list.
  2684.                  Displays a list of the files in memory and allows you to choose
  2685.                  one as the active window.
  2686.  
  2687.      <Ctrl-F3> - Recent-Files Pick list.
  2688.                  Displays a list of the ten most recently edited files and
  2689.                  allows you to choose one to edit.  If the chosen file is in
  2690.                  memory, Pas-Ed switches to the window containing the file.  If
  2691.                  the file isn't in memory, Pas-Ed will load it into the current
  2692.                  window.
  2693.  
  2694.      <F4>      - Open.
  2695.                  Opens a new edit window if enough memory is available.
  2696.  
  2697.      <Alt-F4>  - Close.
  2698.                  Closes the active window and deallocates its memory.
  2699.  
  2700.      <F5>      - Zoom.
  2701.                  Resizes the active window to full or half screen.
  2702.  
  2703.      <F6>      - Next.
  2704.                  Selects the next unhidden window as the active window.
  2705.  
  2706.      <Alt-F6>  - Back.
  2707.                  Selects the previous unhidden window as the active window.
  2708.  
  2709.      <F7>      - Copy.
  2710.                  Displays a pop-up menu showing the files with marked blocks.
  2711.                  The block from the selected file is copied into the active
  2712.                  window at the cursor location.  This option is identical to the
  2713.                  <Ctrl-K><C> block copy command except that it can also copy
  2714.                  between files.
  2715.  
  2716.      <F8>      - Move.
  2717.                  Displays a pop-up menu showing the files with marked blocks.
  2718.                  The block from the selected file is moved into the active
  2719.                  window at the cursor location.  This option is identical to the
  2720.                  <Ctrl-K><V> block move command except that it can also move
  2721.                  between files.
  2722.  
  2723.  
  2724.  
  2725.  
  2726. Chapter 6 - The Pas-Ed Editor                            Pas-Ed Manual - Page 42
  2727.  
  2728.  
  2729.  
  2730.  
  2731.      <F9>      - Make.
  2732.                  Makes (compiles) the file in the active window.
  2733.  
  2734.      <F10>     - Menu.
  2735.                  Opens the menu system.  This option is the same as <Alt-E>.
  2736.  
  2737.      <Alt-F10> - Macro recording off.
  2738.                  Turns macro recording off.
  2739.  
  2740.  
  2741.  
  2742. Entering Text
  2743. ─────────────
  2744.  
  2745. Text is entered into the Pas-Ed editor in a fashion similar to the Turbo IDE.
  2746. Like the IDE, Pas-Ed doesn't wrap lines, and lines must be terminated with
  2747. <Enter>.  As long as the cursor hasn't been moved from the line being edited and
  2748. the line hasn't been erased, the original line can be restored with <Ctrl-Q><L>.
  2749. If the Insert toggle is on, characters are inserted into the text buffer;
  2750. otherwise, characters overwrite the existing text.
  2751.  
  2752. The Pas-Ed editor is a WordStar command editor.  The Turbo Pascal manuals have a
  2753. good explanation of the editing commands.  If you need a quick reference of the
  2754. commands, press <F1> from within the editor to bring up the help menu.  If you
  2755. need a quick reference of the ASCII or extended key codes, press <Alt-A> for a
  2756. pop-up ASCII table and <Alt-K> for an extended key code table.
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784. Chapter 6 - The Pas-Ed Editor                            Pas-Ed Manual - Page 43
  2785.  
  2786.  
  2787.  
  2788.  
  2789.                        Chapter 7 - Hints On Using Pas-Ed
  2790.                        ─────────────────────────────────
  2791.  
  2792.  
  2793.  
  2794. Hint:   Pas-Ed's text buffers are completely independent of one another.  If
  2795.         you've loaded the same file into two windows, remember you aren't
  2796.         editing the same text in two windows but rather two separate text
  2797.         buffers.  Changes made to the text in one window aren't being made to
  2798.         the text in the other window.  If you make different changes in each
  2799.         window and save both windows, the file on disk will contain the changes
  2800.         made to the last window saved.
  2801.  
  2802.  
  2803. Hint:   When working on multi-file programs, always load the main program as the
  2804.         project file.  That way, you can compile, run, or debug the program from
  2805.         any window by using a macro which starts the session and enters <Alt-N>
  2806.         in the File Name window.  For example, the following macro will make the
  2807.         project file:
  2808.  
  2809.              <Alt-C><M><Alt-N><Enter><Enter>
  2810.  
  2811.         This macro opens the Compile menu with <AltC>, selects Make with <M>,
  2812.         uses the <Alt-N> Name hot key to switch the file name to the project
  2813.         file, <Enter> to select the project file as the file to compile, and
  2814.         <Enter> to accept the compiler command line and start the compile.
  2815.  
  2816.  
  2817. Hint:   Although you can record macros which operate across DOS shells and
  2818.         compile, debug, and run sessions, it's usually best not to write them
  2819.         unless you're absolutely sure in advance of the results of the session.
  2820.         For example, at the end of a compile, Pas-Ed always displays a message
  2821.         indicating the results of the compile.  If you write a macro that
  2822.         automatically clears this message, you'll lose any error messages should
  2823.         an error occur, and you'll have to manually examine the error message
  2824.         using the Options/View Last DOS Screen menu option.
  2825.  
  2826.  
  2827. Hint:   Conversely, when using Pas-Ed to compile programs written for languages
  2828.         other than pascal, the ability to write a macro which operates across
  2829.         compile sessions can be a real benefit.  Simply enter the compiler name
  2830.         as one of the five user utilities and the file(s) being compiled as the
  2831.         utility command line along with the compiler command line switches.  For
  2832.         example, we always use a variation of the name "P-xxxxxx.ASM" for our
  2833.         Pas-Ed assembler files.  We have TASM.EXE set up as the third user
  2834.         utility and have as the command line "PAS-*" plus our TASM switches.  We
  2835.         then use the following macro to compile our assembler routines:
  2836.  
  2837.              <Alt-F><U><3><Esc><Alt-F1>
  2838.  
  2839.  
  2840.  
  2841.  
  2842. Chapter 7 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 44
  2843.  
  2844.  
  2845.  
  2846.  
  2847.         This macro opens the File menu, opens the Utility submenu, selects the
  2848.         third option (TASM.EXE), runs the utility (compiles our PAS-xxxx.ASM
  2849.         files), escapes back to the editor, and hot keys to the last DOS screen,
  2850.         which displays the results of the compile.
  2851.  
  2852.  
  2853. Hint:   If your keyboard locks up, try holding down the <Ctrl> key and
  2854.         alternately pressing the left and right shift keys several times.  This
  2855.         will sometimes (not often) unlock the keyboard.  When trying to trace
  2856.         the source of the problem, first check to be sure it wasn't caused by
  2857.         the program you're writing.  If the problem persists across several
  2858.         different programs, it may be a conflict between Pas-Ed's macro
  2859.         processor and another program, such as a TSR.  To check this, turn macro
  2860.         processing off using the Macros/Turn On/Off menu selection.  Pas-Ed is
  2861.         otherwise a plain vanilla program, so if the problem continues after
  2862.         macro processing has been turned off, it's probably not being caused by
  2863.         Pas-Ed.  Try unloading your TSRs one by one to see if you can find the
  2864.         program causing the problem.  As an aside, we regularly use Pas-Ed with
  2865.         SidekickPlus and have had no problems.
  2866.  
  2867.         If your keyboard locks up during a DOS shell or a compile, debug, or run
  2868.         session, then the problem isn't Pas-Ed's macro processor, as it's
  2869.         disabled during these sessions.
  2870.  
  2871.  
  2872. Hint:   If you run out of memory doing an EMS-to-EMS block copy or move, first
  2873.         write the block to a nonsense file, such as TEMP.PAS, using <Ctrl-K><W>,
  2874.         and then read TEMP.PAS into the destination file using <Ctrl-K><R>.
  2875.         Running out of memory during these transfers may indicate that the
  2876.         amount of working DOS memory reserved by Pas-Ed needs to be increased
  2877.         using the Options/Memory Usage/Working Memory menu option.  Since only
  2878.         one EMS-based file can be mapped into DOS memory at once, EMS-to-EMS
  2879.         block transfers are temporarily allocated in working memory.
  2880.  
  2881.  
  2882. Hint:   On a related note, remember if you encounter out of memory messages in
  2883.         any situation to consider raising the amount of working memory reserved
  2884.         by Pas-Ed using the Options/Memory Usage/Working Memory menu option.
  2885.  
  2886.  
  2887. Hint:   If your computer doesn't have EMS memory and you have only one or two
  2888.         windows open, turn the Options/Swap To EMS/Disk menu option off during
  2889.         simple DOS shells and when compiling very small programs.  When EMS/Disk
  2890.         swapping is disabled, the heap is compressed for the exec session, and
  2891.         enough DOS memory for simple operations should be available providing
  2892.         you have only one or, at most, two windows open.  Compressing the heap
  2893.         is very much faster than a disk-based DOS memory swap.  If you receive
  2894.         out of memory messages during these sessions, first, check to be sure
  2895.         you're linking to disk, second, if you have two windows open, try
  2896.         closing one window, and finally turn swapping back on.
  2897.  
  2898.  
  2899.  
  2900. Chapter 7 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 45
  2901.  
  2902.  
  2903.  
  2904.  
  2905. Hint:   If you want to return to your current setup next time Pas-Ed is started
  2906.         but you have another project to work on before exiting Pas-Ed, use the
  2907.         Options/Write Config File menu option to immediately write the
  2908.         PAS-ED.CFG configuration file to disk, thus saving your current setup.
  2909.         Then turn the Config Auto Save option off to ensure that Pas-Ed won't
  2910.         save your new setup upon exit.  When you restart Pas-Ed, your current
  2911.         setup will be restored.
  2912.  
  2913.  
  2914. Hint:   If you have a hint that others might find useful and you wouldn't mind
  2915.         sharing, please sent it to Hedco so it can be included in the next
  2916.         version of the manual.
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958. Chapter 7 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 46
  2959.  
  2960.